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PREFACE 


The first part of this publication 
contains information of a general nature 
and is of interest to anyone, including 
managers, system analysts, and programmers, 
involved in planning or implementing a 
CTAM-ccntrclled telecommunicaticns system 
to operate under the IBM System/360 Disk 
Operating System (DCS)• The topics 
discussed include: devices supported; 
concepts and terminology; QTAM facilities; 
and applications supported. 

The remaining two parts of this 
publication, beginning with the chapters on 
nonaudio and audio message handling 
respectively, describe in detail the 
problem programming necessary fcr 
constructing QTAM message contrcl programs 
to support telecommunications applications. 
A thorough understanding of this 
publication requires a basic kncwledge of 
System/360 machine concepts and the Disk 
Operating System. The prerequisite 
publications are: 

1. IEM System/360 Principles of Operation , 
GA22-6821. 

2. IEM System/360 Disk Operating System, 
System Control and System Service 
Programs , GC24-5036. 

3. IEM System/360 Disk Operating System, 
Data Management Concepts , GC24-3427. 

4. IEM System/360 Disk Operating System, 
Supervisor and Input/Output Macros , 
GC24-5037. 

5. IEM System/360 Disk and Tape Operating 
Systems, Assembler Specifications , 
GC24-3414. 

The reader should also be familiar with 
the following publications that apply to 
equipment in his system configuration: 

Fourth Edition (irarch 1971) 


Telecommunications Control Units: 


1. IBM 2701 Data Adapter,Unit, Principles 
of Operation „ GA22~6864 ~ 


2. IBM 2702 Transmission, Control, , 
GA22-6846 


3. IBM 2703 Transmission, Control ,, 
GA27-2703 


Audio Response Units: 


lm Component Description,, IBM 7770 Audio 
Response Unit, Models, 1„ 2, and 3 m 
GA27-2712 

2o IBM System/360 Component Description, 
IBM 7772 Audio Response Unit ,, GA27-2711 

3„ IBM 7772 Audio Response Unit 
Vocabulary , GA27^2710 

4„ IBM System/360 Disk Operating System, 
Vocabulary File Utility Program for the 
IBM 7772 Audio Response Unit ,, GC27-6924 

Terminal Equipment: 

I* IBM 1030 Data Collection System ,, 
GA24-3018 

2o IBM 1050 Data Communication 

System, Principles of Operation , 
GA24-3474 

3 IBM 1060 Data Communication System , 
GA24-3034 

4. IBM 2260 Display Station, IBM 2848 
Display Control ,, GA27-2700 "" 
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INTRODUCTION 


In the IBM Systeir/360 Disk Operating 
System, an access irethod is a procedure for 
transferring data between main storage and 
an input/cutput device, A variety of 
access methods is available to the user cf 
the Disk Operating System (DCS). One of 
these, the Queued Telecommunications Access 
Method (QTAM), controls data transfer 
between main storage and remote terminals, 

QTAM is an input/cutput control system 
that extends the techniques of logical ICCS 
to the telecommunications environment. 

Files accessed by the problem programmer 
are queues of messages coming in from, or 
going out to, remote terminals via 
communication lines. Although the time and 
order of the arrival and departure of 
messages to and frcm the central processing 
unit (CPU) are unpredictable, the 
programmer can handle the messages as if 
they were organized sequentially. 

Unlike other commonly used access 
methods, QTAM furnishes far more than the 
mechanics for input/cutput operations. In 
addition to the GFT/FUT macro instruction 
support for message processing programs, 
QTAM provides a high-level, flexible 
message control language. QTAM-supplied 
macro instructions can be used to construct 
a complete message control program that 
controls the flew cf message traffic from 
one remote terminal to another (message 
switching application), and between remote 
terminals and any message processing 
programs (message processing applications), 
An installation-oriented message control 
program can thus be written in hours rather 
than in the months previously required for 
such a programming task. 

A QTAM message control program is 
generated from a number of assembler macro 
instructions coded by the programmer. 
Although the assembler macro generator is 
used, the process followed is similar to 
that used by a high-level compiler. A QTAM 
message control program is open-ended. 

That is, the user can include functions not 
provided through the QTAM language by 
employing DOS control program macro 
instructions, and assembler language 
instructions and macro instructions. 

A message control program is completely 
device dependent, with all communication 
lines and terminals identified to the 
system; but„ for the Audio Response Units, 
only the communication lines must be 
identified to the system. Through file 
definition and control information macro 


instructions,, the user specifies his 
equipment configuration and the main 
storage areas (buffers) required for his 
applications. These macros generate the 
tables and lists of control information 
that define the environment of the system 
for the QTAM logic. A primary resource in 
the telecommunications system is the 
buffers, the number and size of which are 
specified by the user. For a nonaudio 
application, the buffers are allocated to a 
common buffer pool from which QTAM 
automatically and dynamically uses them in 
accordance with immediate requirements. 

For an audio application, the buffers are 
strictly associated with the audio lines* 

QTAM logic modules are also provided for 
many procedural functions, such as message 
code translating, routing of messages, and 
error checking. By selecting the 
appropriate macro instructions, the user 
specifies which of these QTAM logic modules 
are to be incorporated into his message 
control program. In this way, the system 
can be tailored to the exact requirements 
of the applications being supported. 

The message processing program services 
of QTAM enable a programmer to process 
messages from a telecommunications network 
with the same easy-to-use macro 
instructions that he uses for his local 
input/output devices. Because a QTAM 
message control program is used to perform 
the input/output operations, a message 
processing program can be device 
independent except for the device control 
characters associated with a particular 
terminal type. The applications programmer 
is, in effect, completely shielded from the 
time and device dependent aspects of the 
telecommunications environment. By using 
some other access method for a sequentially 
organized file, the user can completely 
write and test his message processing 
programs without ever running in the 
telecommunications environment. (For 
example, test input from a card reader can 
be used for this purpose.) Then,, by simply 
changing the definition of a DTF table, he 
can reassemble the message processing 
program to operate under QTAM control. 

This publication is devoted primarily to 
the QTAM facilities provided for the con¬ 
struction of a message control program. 
Message processing programs are discussed 
in general terms and only when necessary to 
give a complete picture of a telecommuni¬ 
cations system using QTAM. For detailed 
information on message processing programs 
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and the services QTAM provides in support¬ 
ing their, refer tc the publication, IBM 
Systeir/360 Disk Operating System, QTAM Mes¬ 
sage Processing Program Services , Forir 
C30-5C03. 


CONTROL UNITS SUPPORTED 

Combinations of IEM 7770 and/or 7772 
Audio Response Units attached tc a multi¬ 
plexer channel, and/cr any combination of 
IBM 2701, 2702, or 2703 telecommunications 
control units attached to the same multi¬ 
plexer channel may be supported by DCS/ 
QTAM. Up to eight control units can be 
attached to the multiplexer channel. DOS/ 
QTAM additionally supports the IBM 2848 
Display Control attached directly either to 
the multiplexer or a selector channel. 

If using the IEM System/360 Model 25 
with the Integrated Communications Attach¬ 
ment/, operation and program set-up is the 
same as for the Model 30 with a 2703 Trans¬ 
mission Control Unit attached tc a multi¬ 
plexer channel (switched and nonswitched 
lines). 


TERMINAL TYPES SUPPORTED 

DOS/QTAM supports the following types of 
terminals: 

1. Terminals attached to a multiplexer 
channel through an IBM 2701, 2702, or 
2703 telecommunications control unit: 

• IBM 1050 Data Communication System on 
a switched network or on a 
nonswitched network. 

• IEM 1060 Data Communication System on 
a nonswitched network. 

• IBM 1030 Data Collection System on a 
nonswitched network. See Note 1. 

• IEM 2260-2848 or 2265-2845 Display 
Complex (remote) on a nonswitched 
network (2701 only). 

Note : Within this SRL,, all comments 

which refer tc the 2260-2848 Remote are 
also applicable to the 2265-2845. 

• AT6T 83E3 Selective Calling Stations 
on a nonswitched network. 

• Western Union Plan 115A Outstations 
on a nonswitched network. 

• Common Carrier (8-level cede) TWX 
Stations on a switched network (for 
example, WU Model 33 or 35 
Teletypewriter Terminal^-dial 
service). 


• World Trade telegraph terminals (WTTA 
terminals) on a nonswitched network,, 
attached to a 2701,, 2702* or 2703 
Control Unit. See Note 2. 

• IBM 2740 Communications Terminal on a 
nonswitched network* four types: 

Basic 2740 

Basic 2740 with station control 

Basic 2740 with station control and 
checking 

Basic 2740 with checking. 

• IBM 2740 Communications Terminal on a 
switched network,, four types: 

Basic 2740 

Basic 2740 with transmit control and 
checking 

Basic 2740 with checking 

Basic 2740 with transmit control. 

DOS/QTAM supports the following device 
attached directly either to the multiplexer 
or a selector channel: 

• IBM 2260-2848 Display Complex (Local). 

2. Terminals attached to a multiplexer 
channel through an IBM 2702, or 2703 
transmissions control unit equipped 
with the Auto Poll feature: 

• IBM 1050 Data Communication System on 
a nonswitched network. 

• IBM 1060 Data Communication System on 
a nonswitched network. 

• IBM 1030 Data Collection System on a 
nonswitched network. See Note 1. 

• IBM 2740 Communication Terminal on a 
nonswitched network when equipped 
with the Station Control feature: 

Basic 2740 with station control 

Basic 2740 with station control and 
checking 

• IBM 2740 Model 2 Communication 
Terminal on a nonswitched network 
when equipped with station control* 
with or without checking, and with or 
without the Buffer Receive feature. 

3. Audio terminals attached to a 
multiplexer channel through an IBM 7770 
Model 3 or 7772 Audio Response Unit on 
a switched network: 
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• IBM 1001 Data Transmission Terminal 

• IBM 1092/3 Programed Keyboard 

• IBM 3944 Dial Terminal (World Trade 
terminal attached only to the IBM 
7772 with Dial Terminal Feature) with 
rotary dial telephone 

• Standard rotary dial, push button 
telephones, or similar terminals 

Mete : Any reference in this document 
tc the IBM 7770 cr 7772 implies their 
associated terminals* 

Mote 1 : The IEM 1032 Digital Time Unit 
cannot be attached through a 2701 Data 
Adapter Unit* 

Mete 2 : Throughout this publication, 

•World Trade telegraph terminal* (WTTA 
terminal) refers to a terminal as defined 
on page 30 , connected to a control unit 
that incorporates a World Trade Telegraph 
Adapter* A World Trade line (WTTA line) is 
a line connected in the same manner to a 
WTTA terminal* 


MACHIMB AND DEVICE REQUIREMENTS 


QTAM operates on any System/360 having 
at least 64K cf main storage. The only 
additions to the minimum requirements of 
the System/360 Disk Cperating System are: 

• All telecommunications terminals, 
except the IBM 2260-2848 local, must be 
attached to an IEM 2701 Data Adapter, 
or an IBM 2702 or 2703 Transmission 
Control Unit, cr an IEM 7770 or 7772 
Audio Response Unit; they cannot be 
attached directly to a channel. 

• All IEM 2701, 2702V, 2703, 7770 or 7772 
Control Units that operate under QTAM 
must be attached to the System/360 via 
the multiplexer channel. 

• Nc device may be operated in burst mode 
on the multiplexer channel concurrently 
with the operation of QTAM, except when 


*A switch on the CE panel on the 2702 can 
be used to place a given line in CE mode 
for equipment checking* Care must be 
taken to ensure that no lines are in CE 
mode when QTAM is used since nc ending 
status will be returned to a SIC command* 


the QTAM operation involves only the 
2260 Local. 

• The storage protection feature is 
required. 

• The IBM 1052 Printer-Keyboard is 
mandatory. 

The following additional features may be 
required if certain optional functions 
provided by QTAM are desired: 

• The interval timer feature, if 
time-of-day information in messages, 
the polling interval function, the 
checkpoint interval function, or the 
operator control INTREL function is 
desired or if IBM 2740 Model 2 
Terminals are included in the system* 

• The line correction feature on IBM 1050 
terminals if automatic retry is desired 
when a transmission error occurs. 


GENERAL REQUIREMENTS AND CAPABILITIES 

To construct a telecommunications system 
to operate under control of QTAM, in the 
Disk Operating System environment, the user 
must write: 

1. A message control program, and 

2. Any message processing programs 
required by his application* 

A telecommunications control system 
created through the use of the QTAM message 
control language can: 

• Establish contact and control message 
traffic between computer and terminals, 

• Dynamically assign and use buffers as 
required, 

• Perform editing of incoming and 
outgoing messages (for example, code 
translation, insertion of new fields in 
message headers), 

• Forward messages to destination 
terminals and message processing 
programs, 

• Take corrective action and provide 
special handling for messages 
containing errors, 

• Maintain statistical information about 
message traffic. 
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TELECOMMUNICATIONS SYSTEM CONCEPTS AND TERMINOLOGY 


This section describes the line and ter¬ 
minal configuration of a telecommunications 
system operated under control of QTAM and 
the IBM Systero/360 Disk Operating System, 
and defines seme terms used in this publi¬ 
cation* A telecommunications system (or 
network) consists of a number of input, 
output, or combined input/output devices, 
usually in geographically dispersed loca¬ 
tions, connected by one or more communica¬ 
tion lines* As used in this publication, a 
telecommunications system operating under 
DOS/QTAM may be more specifically defined 
as a network of terminals connected to a 
central computer by cne or more half-duplex 
communication lines* A half ^-duplex line is 
a line over which data can flow in either 
direction, but only in one direction at a 
time* 


In communication terminology, special 
terms are used to represent the media that 
connect the physical components of a syste¬ 
ms communication line, data link, data 
path, circuit, and channel. In this publi¬ 
cation, the term communication line (or 
line ) is used to refer to any medium that 
connects the physical components of a sys¬ 
tem, whether a telegraph circuit, a tele¬ 
phone circuit, a private circuit, etc. The 
term audio communication line (cr audio 
line )is used for lines attached to the 
audio response units, and always refers to 
a telephone circuit. Conversely, wherever 
the audio response units are specified, the 
associated communication line (cr line ) is 
implied* 

A terminal is the unit or units of equi¬ 
pment that accepts keyed or punched data as 
input for sending to the computer and/or 
produces printed, punched, or visually dis¬ 
played data as output received from the 
computer. All messages from cne terminal 
to another pass through the computer; in 
addition, the computer may itself receive 
and originate messages for the terminals. 

A terminal consists of a control unit 
and one or more input/output devices. Each 
such device is called a component . Each 
input device and each output device is ccn~ 
sidered a separate component, regardless of 
whether they are physically combined. For 
example, an IBM 1050 is referred to as a 
terminal; its constituent devices, or com¬ 
ponents, include the IBM 1053 Printer, 1054 
Paper Tape Reader, keyboard section of the 
1052 Printer-Keyboard, printer section of 
the 1052 Printer-Keyboard, etc. 


An audio terminal is the unit of equip¬ 
ment associated with an audio response 
unit, that accepts keyed or dialed data as 
input for sending to the computer and/or 
produces an audio response as output 
received from the computer. When an audio 
terminal has established the connection 
through an audio communication line, the 
computer receives the input message and 
sends the audio output message to the same 
audio terminal. Audio response units may 
be referred to as terminals. 

Terminals in a telecommunications system 
operated under DOS/QTAM control are classi¬ 
fied as either remote or jLocal terminals. 
The main distinction is how the terminals 
are attached to the computer. The IBM 7770 
or 7772 Audio Response Unit (ARU) and ter¬ 
minals attached to the computer channel 
through an IBM 2701, 2702, or 2703 Tele¬ 
communications Control Unit (TCU) are clas¬ 
sified as remote. With the exception of 
the IBM 2260 Local, all supported terminals 
fall under this classification. Remote 
terminals are usually separated from the 
computer by a distance sufficient to 
require common-carrier facilities and tran- 
mission techniques to communicate with the 
computer. The system, however, may include 
terminals at the same location as the com¬ 
puter, attached to it through a TCU and 
local cables. Units that are connected 
directly to a System/360 channel, such as 
the 2260-2848 Display Complex (Local), are 
classified as local . 

Each remote terminal, each TCU, and each 
ARU is connected to a communication line by 
a data set, a modem (modulator demodula¬ 
tor), etc., depending on the kind of com¬ 
munication line and kind of terminal 
involved. (Terminals connected to the TCU 
by local cables do not require data sets.) 
The precise functions of these units vary, 
but the overall purpose is the same: to 
provide an interface between terminal and 
line. This publication uses the term data, 
set to represent any of these units. Th4 
programmer need not concern himself in any 
way with these data sets because their pre¬ 
sence exerts no influence on programming. 
They are defined only to provide a com¬ 
plete, accurate picture of the line and 
terminal configuration. 

The term station means the aggregate of 
equipment and controls attached to any of 
the several ends of a communication line. 

A station can also be described as a termi¬ 
nal (including the terminal components) 
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plus the equipment by which the terminal is 
attached to the line. 

In this publication, computer is used as 
a general terir fcr the equipment and pro¬ 
grams at the central processing location 
(CPU, TCU, ARU, etc.), when reference to a 
specific unit of equipment or programming 
is not necessary. 


TELECCEMUNICATICKS NETWORKS 


A telecommunications system consists cf 
either a nonswitcbed network, a switched 
network, or a combination of the two. 

Figure 1 shows the configuration o£ an 
installation that includes both a ncn- 
switched network and a switched network. 

A nonswitched network consists of a 
number of private or leased lines that con¬ 
nect the computer tc one or mere remote 
terminals. The computer and the terminals 
are physically connected; that is, the cir¬ 
cuits making up the communication lines are 
continuously established for predetermined 
time periods during which data transmission 
may proceed between the computer and the 
terminals. In this type of system, the 
computer can, under certain conditions, 
send messages tc mere than one terminal on 
the same line at the same time. The lines 
comprising a nonswitched network are known 
as either private, leased, or dedicated 
lines. Such lines usually are furnished by 
a common carrier on a contract basis, 
between specified locations fcr a con¬ 
tinuous period or regularly recurring 
periods at stated hours, for the exclusive 
use of one customer. 

A switched network consists cf a number 
of remote terminals with which the computer 
can communicate. The computer and the sev¬ 
eral terminals are each continually con¬ 


nected, by access lines ,; to the common- 
carrier exchanges serving their respective 
locations. A complete, continuous data 
path is established between computer and 
terminal only for the period of time in 
which transmission takes place. The con¬ 
nection is established by dialing the tele¬ 
phone number of the unit (either terminal 
or CPU) on the other end. In this type of 
system, communication can be established 
between the computer and only one terminal 
at a time on each: line. In this case,, line 
refers to a discrete data path between the 
telecommunications control unit and the 
common-carrier exchange. The service pro¬ 
vided by the common carrier is typically on 
a time-used basis. 

In a nonswitched network, the physical 
circuit connections determine which ter¬ 
minals are associated with each line into 
the computer. In a switched network, the 
user can, by several means, specify which 
terminals can communicate with the computer 
over each line. 

A switched network is used by the audio 
response units, but the connection is 
always established from an audio terminal 
by dialing the telephone number of an audio 
communication line enabled (activated) by 
the computer. Depending on the dialed 
number, the terminal can communicate with 
the computer on a specified line of a spe¬ 
cified ARU. 

Some communication networks have charac¬ 
teristics typical of both switched and non¬ 
switched networks. In this publication, 
the term switched network refers to any 
network in which a direct physical connec¬ 
tion between computer and terminal must be 
established by dialing in order for data 
transmission to occur. The term non¬ 
switched network refers to a network in 
which the communication lines linking com¬ 
puter and terminals are continuously estab¬ 
lished, thus requiring no dialing. 
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MESSAGE CONTROL 


Accomplishing efficient systematic 
supervision of message traffic is the job 
of the QTAM message control facilities. In 
some respects, the functions performed by 
QTAM message control procedures parallel 
those performed in telecommunications sys¬ 
tems that are not computer-oriented. 


This section provides a general descrip¬ 
tion of telecommunications systems followed 
by a discussion of the main functions per¬ 
formed in a computer-based system operated 
under QTAM control. Subsequent sections of 
this publication explain how these func¬ 
tions are implemented. (In the following 
discussion, the term computer includes both 
the physical equipment at the central loca¬ 
tion and the Disk Operating System pro¬ 
grams. The word terminal is used for the 
equipment at remote or local locations.) 

In any telecommunications system, con¬ 
tact between terminals must be established 
befcre a message is sent. In seme systems, 
terminals wishing to send a message contend 
with cne another for use of the line. The 
first terminal to initiate contact on a 
line that is not currently in use seizes 
the line and prevents its use by other ter¬ 
minals until it has concluded its message 
transmission. A system operated in this 
manner is called a contention system. 

Audio communication lines, WTTA lines, and 
the IEM 2260-2848 Iccal always operate as 
contention systems. 

In ether systems, cne of the terminals 
is specified as the control station . This 
control station initiates all contacts for 
all other terminals cn the line, using a 
procedure known as polling. Tolling is a 
flexible, systematic, centrally controlled 
method of permitting terminals cn a multi¬ 
terminal line to transmit without contend¬ 
ing for use of the line. The control sta¬ 
tion periodically contacts the ether ter¬ 
minals and invites them to send any mes¬ 
sages they have ready. In addition, the 
control station itself may elect to send a 
message. A system operated in this manner 
is called a polling system. 

Polling is accomplished by sending on 
the line one or mere polling addresses 
each of which consists of one or more pol¬ 
ling characters. Typically, two characters 
are used; the first selects the terminal, 
the second selects the specific component 
of that terminal. The terminal identified 
by these characters then sends a response 
to the control station—a positive response 
if it has a message to send, a negative 
response if it does net. The control sta¬ 
tion may poll a number of terminals and 


components, in turn, until one is found 
that has a message ready. 

Similarly, when the control station ter¬ 
minal, or any other terminal, has a message 
to send, it transmits on the line one or 
more addressing or call-directing charac¬ 
ters. As in polling, two characters are 
often used: the first selects the termi¬ 
nal; the second selects the component. The 
terminal identified by these characters 
returns a response. A positive response is 
returned if the terminal is able to accept 
the message; a negative response is 
returned if the terminal cannot accept the 
message. 

The nonaudio communication lines operate 
within a polling system in which the com¬ 
puter acts as the control station (although 
certain types of the IBM 2740 Communication 
Terminal employ techniques similar to those 
used by a contention system). The entire 
contention and/or polling telecommunication 
system operated under QTAM is a centralized 
system; that is, terminals send their mes a 
sages, not to other terminals, but to the 
computer. The computer then relays the 
messages to the appropriate destination 
terminals (or to a message processing pro¬ 
gram) or sends the response to an audio 
terminal. 


QTAM POLLING SYSTEM 


The polling and addressing functions are 
performed in both switched and nonswitched 
systems, with minor variations. 

In a switched network, the line connec¬ 
tion must be completed between computer and 
terminal before message transmission can 
proceed. The connection may be established 
by either the computer or a terminal. When 
the computer is to establish the connec¬ 
tion, it dials the telephone number of the 
terminal (the user provides QTAM with the 
telephone number of each terminal in the 
switched network). The connection is 
established when the terminal responds. 

The function performed by the computer, in 
this case, is known as cabling . Polling or 
addressing may then take place. Ordinari¬ 
ly, the computer calls a terminal only for 
the purpose of addressing the terminal (to 
send it a message), rather than polling it 
(to solicit messages). When a terminal is 
to establish the connection, the user dials 
the telephone number of the computer (or 
one of its several numbers). The connec¬ 
tion is established when the computer 
responds; the function performed by the 
computer in this case is known as answer¬ 
ing . Polling or addressing may then take 
place. Ordinarily, a terminal calls the 
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computer only in crder to be polled for a 
message it has ready for the computer or 
another terminal, Ncte that regardless of 
whether the computer or the terminal estab¬ 
lishes the line connection, message flow 
from the terminal to the computer is 
achieved by polling the terminal, and mes¬ 
sage flow from the computer to a terminal 
is achieved by addressing the terminal. 


Although terminals are permitted to call 
the computer at any time, the computer, in 
order to fulfill its function as control 
station* must be able to accept or reject 
incoming calls. Therefore, the computer 
performs a functicn known as enabling the 
line . Enabling the line is the process of 
conditioning the telecommunications control 
unit tc accept incoming calls on a line. 

The user determines which lines are and 
which are not to be enabled at a given 
moment. If a terminal calls in on a line 
that is currently enabled and that is not 
in contact with another terminal, the line 
connection is completed and message trans¬ 
mission (preceded by polling or addressing) 
can occur. If a terminal calls in on a 
line that is not currently enabled, contact 
is not established. However, if the line 
has been enabled but is occupied with 
another terminal, the calling terminal 
receives a busy signal. In either case, 
the terminal must wait and call again 
later. 


In a nonswitched network, the line con¬ 
nections between computer and terminals are 
continuously established; hence, the cal¬ 
ling, answering, and enabling functions are 
not reguired. Only the computer can initi¬ 
ate contact with terminals (except for cer¬ 
tain types of IEM 2740 Communications Ter¬ 
minals and the IBM 2260 Display Station 
(local), which can bid for the computer's 
attention). After the line connection is 
established* the computer addresses ter¬ 
minals to send messages to them, and con¬ 
tinually and systematically pells terminals 
to solicit messages from them. 

For nonswitched lines, the polling pro¬ 
cess may be achieved under the control of 
an entirely programmed capability or under 
the control of the Auto Poll feature. 
Throughout this publication, auto polled 
lines refer tc lines polled under the con¬ 
trol cf the Auto Poll feature, while polled 
lines refer to lines polled under the con¬ 
trol cf the program capability. 

The contention technique of initiating 
contact on a line net currently in use is 
used by WTTA terminals and by the four 
types of IBM 2740 Communications Terminals 
which have neither station control nor 
transmit control. 


In a contention system either the termi¬ 
nal operator or the computer can initiate 
contact on an available line connecting 
them. In any contention system, it is 
possible for contact to be initiated at 
both ends of a communications line at the 
same time. (For WTTA terminals, refer to 
the note below.) When this occurs, the 
teleprocessing system will generally mal¬ 
function. This situation is extremely rare 
(it requires that the terminal operator 
simultaneously hit the EOT and BID keys 
when terminating entry of one message and 
initiating contact to enter another message 
at the same time that the computer has a 
message to send to the terminal), and is 
avoided completely if the terminal operator 
allows a normal I/O reaction time between 
EOT and BID. For example, if the terminal 
operator uses the same finger to hit the 
EOT and BID keys, "normal" I/O reaction 
time is provided. 

Note: If the first character of an input 

message is received at the same time as the 
computer sends a character to the terminal, 
contention occurs and is resolved as 
follows: 

1. If contention occurs during the user- 
specified interval required by the ter¬ 
minal motor to reach nominal speed, the 
terminal is given priority. 

2. If contention occurs on a significant 
character of an output message, the 
computer is given priority. 


AUDIO SYSTEM ON A SWITCHED NETWORK 


The line connection must be completed 
between computer and audio terminal before 
message transmission can proceed. The con¬ 
nection can be established only by the ter¬ 
minal. The terminal operator dials the 
telephone number of the computer (or one of 
its numbers) and the connection is estab¬ 
lished if the computer allows it. 

Although ARU terminals are permitted to 
call the computer at any time, the comput¬ 
er, in order to fulfill its function as 
control station, must be able to accept or 
reject incoming calls. Therefore, the com¬ 
puter performs a function known as enabling 
the line . Enabling is the process of con¬ 
ditioning the audio control unit to accept 
incoming calls on a line. The user deter¬ 
mines which lines are, at a given moment, 
to be enabled, and which are not. If a 
terminal calls in on a line that is cur¬ 
rently enabled and that is not in contact 
with another terminal, the line connection 
is completed and message transmission can 
immediately occur. If a terminal calls in 
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cn a line that is net currently enabled* 
contact is not established. However, if 
the line has been enabled but is occupied 
with another terminal, the calling terminal 
receives a busy signal. In either case* 
the terminal irust wait and call again 
later. 


MESSAGE PROCESSING 


Message processing is the most variable 
of all telecommunications functions. The 


nature of each user's processing routines 
depends on the individual application. 

QTAM provides macro instructions enable 
ing the user's problem program to obtain 
messages queued for processing and to place 
a response message on destination queues. 
For nonaudio terminals, QTAM also provides 
a set of macro instructions for examining 
and modifying control information used by 
the access method. For detailed informa¬ 
tion on message processing,, refer to the 
Message Processing Program Services publi¬ 
cation listed in the Preface of this 
manual. 
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DCS QTAM CONCEPTS AND FACILITIES 


GENERAL CONCEPTS AND FACILITIES 


The function of programs constituting 
support for a telecommunications system is 
to control, systematically and efficiently, 
the flow of data in a computer-based tele¬ 
communications system, and to perform, con¬ 
currently, any required processing cf the 
data. Data enters the system randomly in 
the form of messages from terminals and/or 
from pregrams that generate messages; data 
is ultimately delivered to one cr more ter¬ 
minals cr programs that process messages. 
The messages entered at the terminals con¬ 
sist cf two principal parts, the message 
header, consisting of control information, 
and the message text cr data. 

For a number of reasons, the support is 
logically divided into two categories: 

1. The programming required tc identify 
the telecommunications system to the 
IEM Systeir/360 Disk Operating System, 
to establish the line control discip¬ 
lines required for the various types 
of terminals and modes of connection, 
and to control the routing of messages 
in accordance with the user's require¬ 
ments; and 

2. The programming required tc process 
the contents cf the messages. 

The first category is implemented by 
routines collectively known as the message 
control program which is primarily con¬ 
cerned with the message header. The second 
category is implemented by one cr more mes¬ 
sage processing programs which are primari¬ 
ly concerned with the message text or data. 

The paramount reason for dividing tele¬ 
communications support into these types of 
programs is that message flow in the system 
is random and proceeds at relatively slow 
speeds (due to the operating speeds of the 
terminals supported), while the messages, 
once delivered to the computer, can be pro¬ 
cessed at computer speeds. To fully uti¬ 
lize the computing system capabilities, 
message traffic must proceed simultaneously 
with message processing,. Another reason 
for having separate message control and 
message processing programs is that while 
many device-dependent considerations govern 
the design of a message control program, 
they dc not affect the design of a message 
processing program. The programmer writing 
a message processing program need know only 


the format of the messages and the charac¬ 
teristics of the data they contain to be 
able to proceed with the program design. 

A message control program serves as an 
intermediary between the remote terminals 
and any message processing programs. The 
device-dependent input/output operations 
are performed by QTAM routines that support 
the message control program, based on the 
terminal and line configuration of the 
user's system as specified in the operands 
of QTAM macro instructions. To provide 
maximum efficiency, QTAM uses the operating 
technique of placing messages on queues on 
a direct access storage device CDASD), when 
necessary, and subsequently retrieving 
these messages for processing. This 
enables the terminals to be referenced 
indirectly, in much the same way as local 
input/output devices are referenced. This 
is accomplished from a message processing 
program using language statements such as 
GET, PUT, OPEN, and CLOSE. 

When messages are associated with audio 
terminals, QTAM places them in main storage 
queues. A message processing program using 
language statements such as GET, PUT, OPEN, 
and CLOSE, retrieves audio input messages 
from a main storage queue, processes them, 
and sends the audio response to another 
main storage queue. 

The message control program itself can 
perform limited processing of the message, 
in addition to that performed by a message 
processing program. Some of these proces¬ 
sing operations may be required in order 
for the message control program to perform 
its function: 

• For nonaudio messages, scanning the 
header to determine routing information 
and message code translating. Other 
optional processing operations are pro¬ 
vided by QTAM as a convenience to the 
user. For example, the message control 
program can insert the time of day in 
message headers, obviating the need for 
a message processing routine to do 
this. 

• For audio messages, message code trans¬ 
lating. Other optional processing 
operations are provided by QTAM as a 
convenience to the user. For example, 
the message control program can check 
the input messages to determine if an 
audio error message must be sent to the 
calling terminal. 
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Every telecommunications system operated 
under QTAM requires cne and only one mes¬ 
sage control program. Depending on the 
application* cne cr more processing pro¬ 
grams may be required, or none at all 
(limited to two by the number of available 
partitions)An example of a ncnaudic 
application requiring no message processing 
program is a message switching application, 
in which the sole function of the tele¬ 
communications system is to receive mes¬ 
sages from terminals and forward them unal¬ 
tered (except for such processing as the 
message ccntrcl pregram may perform) to one 
or more other terminals. An example of an 
audio application requiring no message pro¬ 
cessing program is a standard audio answer¬ 
ing application, in which the scle function 
is to answer with an invariable audio 
answer without receiving any input message. 


A telecommunications system may include 
several different terminal types, and both 
switched and nonswitched line types. For 
each combination of line type and terminal 
type, the user must specify a sequence of 
QTAM message control macro instructions. A 
separate sequence is normally written for 
each communication line group. A communi¬ 
cation line group consists of one or more- 
communication lines of the same type , over 
which the same type of terminal can commun¬ 
icate with the computer. Each sequence of 
message control macro instructions is 
called a line procedure specification 
(LPS); the several LESS collectively con¬ 
stitute the heart of the message control 
program. For an audio line group, cne 
refers to an Audio IPS. 

Ey way of example, assume that a tele¬ 
communications system is to consist of four 
nonswitched lines to which IBM 1050 ter¬ 
minals are connected, one switched line 
over which contact with IEM 1050s can be 
made, three nonswitched lines to which IEM 
2260s are connected, and two switched lines 
over which contact with TWX terminals can 
be made. The system would then have four 
line groups: a nonswitched 1050 group, a 
switched 1050 group, a nonswitched 2260 
group, and a switched TWX group. A separ¬ 
ate LPS would be required for each group. 

Each LPS consists of user-selected macro 
instructions in two groups: a "receive 
group", which defines the routines required 
to operate on incoming messages from any 
line in the line group; and a “send group 9 „ 
which defines routines required to operate 
on outgoing messages to any line in the 
line group. 

For the audio communication line groups, 
each IPS (or Audio IPS) consists of user^ 
selected audio macro instructions, which 
define the routines required to operate 


only on incoming messages from any audio 
line in the line group. 


OPERATING ENVIRONMENT 


A telecommunications system operating 
under DOS/QTAM exists in a multiprogramming 
environment. A message control program is 
always executed as a foreground-one pro^ 
gram, regardless of the presence or absence 
of other programming components in 
foreground-two or background. Concurrently 
with the execution of the message control 
program, one or two message processing pro¬ 
grams can operate in the foreground-two or 
background partitions. The task selection 
mechanism of the DOS Supervisor controls 
the asynchronous operation of all program¬ 
ming components in the system. This method 
of execution is based on: 

1. The completion of awaited events such 
as I/O termination and the availabil¬ 
ity of resources (for example* buf¬ 
fers), and 

2. The established priorities of 
foreground-one, foreground-two* and 
background. 

After being assembled, linkage edited* 
and cataloged into the core image library* 
a message control program can be loaded and 
executed in foreground-one. This is accom¬ 
plished by the foreground initiation rou¬ 
tine as the result of an operator message 
keyed into the system via the 1052 Printer 
Keyboard. The procedure is the same for a 
message processing program to be executed 
in foreground-two. A message processing 
program to be executed as a background pro¬ 
gram is initiated by Job Control from the 
batched-job input stream. In any case, the 
message control program must be initiated 
before any message processing program. For 
detailed information on initiating fore¬ 
ground and background programs, refer to 
the System Control and System Service Pro¬ 
grams publication listed in the Preface of 
this manual. 

With multitasking, it is possible to 
perform multiprogramming within one or all 
of the background, foreground-one, and 
foreground-two partitions. In a multitask¬ 
ing environment, processing in a single 
partition is possible; the message control 
program can operate concurrently with one 
or more processing programs in the 
foreground-one partition. Within the par^ 
tition, the subtasks have higher priority 
than the main task, with the first attached 
subtask having the highest priority and the 
last attached subtask having the lowest 
priority. (For a complete discussion of 
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Multitasking, see the DCS Supervisor and 
Input/Cutput Macros publication.) The main 
task irust first attach the message control 
program and then the message processing 
programs. The main task may also deactiv¬ 
ate the partition after the QTAM subtasks 
have closed. 

Note : In multitasking the roaintask cannot 

use the STIXIT JT if QTAM is attached with 
operator control, checkpoint by timer 
interval, polling interval facilities, or 
2740 Model 2. 

Depending cn the requirements of the 
user,, a System/360 that includes Tele¬ 
processing may be either: 

1. Dedicated to Teleprocessing, or 

2. Set up to execute non-Teleprocessing 
jobs concurrently with the execution 
of Teleprocessing jobs. 

The system is dedicated to Tele¬ 
processing when all three partitions are 
allocated to programs performing Tele¬ 
processing functions; that is, a message 
control program is executing in foreground- 
one, and message processing programs are 
executing in foreground-two and in 
background. 

At the other extreme, if no message pro¬ 
cessing program is continuously required by 
the Teleprocessing application, non-Tele¬ 
processing pregrams can be executing in 
foreground-two and background. An example 
of such a configuration is: normal batch 
processing in the background partition, 
concurrent peripheral operations in 
foreground-two, and a message control pro¬ 
gram performing Teleprocessing functions in 
foreground-one. Such a configuration can 
exist only when the message control program 
can perform the required Teleprocessing 
functions without the support of a message 
processing program (for example, a message 
switching, data collection, or standard 
audio answering application). However, 
where it is necessary to terminate opera¬ 
tion of the message control program, a mes¬ 
sage processing program must be initiated 
in the foreground-two or background parti¬ 
tion to perform this function. This 
requires temporary termination of one non- 
Teleprccessing program if two such programs 
are executing at the time the message con¬ 
trol program is tc be terminated. 

Typically, a Teleprocessing application 
that requires message processing is sup¬ 
ported by only one message processing pro¬ 
gram (in addition to the message control 
program). One message processing program 
can be designed tc process all message 
types and to terminate the message control 
program when necessary. This leaves one 


partition available for the execution of a 
non-Teleprocessing program, and thus 
enables the user to take fullest advantage 
of the multiprogramming capabilities of 
DOS. An example of such a configuration 
is: normal batch processing in background; 
and a message processing program in 
foreground-two and a message control pro¬ 
gram in foreground-one performing Tele¬ 
processing functions. 

Multitasking extends the multiprogram¬ 
ming capabilities of the Disk Operating 
System to execute twelve programs rather 
than three, since one partition can contain 
up to ten programs operating concurrently. 
Message processing programs can be executed 
in the same partition (foreground-one) as 
the message control program or in the 
remaining system partitions. 


FILE DEFINITION AND CONTROL INFORMATION 


For each file referred to by the message 
control and message processing programs, a 
DTF table must be defined by means of file 
definition macro instructions. A DTFQT 
macro instruction must be provided for each 
of the following types of QTAM files: 

• Each communication line group (message 
control program)• 

• Direct access message queues (message 
control program—not applicable to 
audio response units). 

• DASD checkpoint records file (message 
control program). 

• 7772 Digitally Coded Voice (DCV) voca¬ 
bulary (message control program), 
required when at least one 7772 ARU is 
present in the system. 

• Each main storage process queue (mes¬ 
sage processing program). 

• Each main storage destination queue 
(message processing program—- not 
applicable to audio messages). 

• Each audio output queue (message pro¬ 
cessing program). 

Similarly, an appropriate DTFxx macro 
instruction must be provided for each mes¬ 
sage log used by the message control pro¬ 
gram. The actual DTFxx used is a function 
of the storage medium used for the message 
log (for example, DTFMT would be used for 
magnetic tape). 

The DTF tables in a message control pro¬ 
gram serve as a logical connector between 
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the message control program and the asso¬ 
ciated line group, EASD message queues, 

7772 ECV vocabulary, and message log files. 
The DTF tables defined in a message proces¬ 
sing program are net associated with files 
themselves. They are used to provide con¬ 
trol information to QTAM for the transfer 
of data to and frem a message processing 
program. The main storage (MS) process and 
destination queues and the audic output 
queue are the main connectors between a 
message control pregram and a message pro¬ 
cessing program. 


In addition tc the file definitions, the 
user must supply control information (in 
the ferm of macro instructions) that is 
used by the message control program to con¬ 
trol the sending and receiving cf messages. 
The control information consists of: 


• The name and address of each terminal 
with related information, such as any 
special distribution lists for sending 
a message to more than one terminal 
(net applicable to audio lines). 


• The name cf each EASD process queue 
associated with a message processing 
program to which incoming messages are 
tc be sent. 


• A polling list for each line that indi¬ 
cates the order in which the terminals 
on the line are to be polled (net 
applicable tc audio lines). 

• The size and number of main storage 
buffers that are to be used for sending 
and receiving messages to and from the- 
terminals. in order to compensate fer 
the differences in the rates of infor¬ 
mation flow, QTAM automatically and 
dynamically uses available buffers in 
accordance with immediate needs (not 
applicable tc audic lines). 

• The name of each audio communication 
line together with related information, 
such as line group name. 

• The size and number of main storage DCV 
buffers used to transmit messages to 
the terminals (fer each IBM 7772 ARU 
transmitting ECV words dynamically 
retrieved from EASD). QTAM automatic¬ 
ally and dynamically uses available 
buffers from the corresponding DCV 
buffer pool in accordance with immedi¬ 
ate needs. 

• The name and Iccation of 7772 DCV voca¬ 
bulary words to be permanently kept in 
main storage. 


QTAM FACILITIES 


The QTAM facilities include a comprehen¬ 
sive set of input/output, message control,, 
translating, and editing routines that 
relieve the programmer of the detailed and 
specialized programming normally required 
in writing a message control program for a 
telecommunications system. Macro instruc¬ 
tions are provided that allow the program¬ 
mer to assemble and linkage edit these rou¬ 
tines into an integral message control pro¬ 
gram designed to meet the exact require¬ 
ments of an installation. 

For nonaudio terminals,, the primary 
capabilities of the telecommunications pro¬ 
grams that can be created through the use 
of QTAM macro instructions are: 

• Polling terminals 

• Receiving messages from terminals 

• Addressing terminals 

• Sending messages to terminals 

• Dynamically assigning and using avail¬ 
able buffers as required 

• For incoming messages*, performing mes¬ 
sage editing functions such as: trans¬ 
lating from the transmission code in 
which messages are sent to extended 
binary coded decimal interchange code 
(EBCDIC); inserting time-received and 
date-received information in the head¬ 
er; recording (logging) the message on 
a secondary storage medium such as mag¬ 
netic tape; and maintaining a count of 
the number of messages received from 
each terminal 

• Routing messages to appropriate queues*, 
determined by either the destination 
code specified in the header of the 
message,, or the source from which the 
message entered the system 

• Queueing messages on a direct access 
storage device 

• Initiating corrective action when an 
error or unusual condition is detected 

• Intercepting transmission of messages 
in error 

• Cancelling messages containing errors 

• Rerouting messages 

• Transmitting error message^ 

• Routing messages with erroneous header 
information to a special queue 
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• Providing message data* in the work 
unit specified (message* message seg¬ 
ment, or record), to a message proces¬ 
sing program 

• Placing response messages generated by 
message processing programs on queues 
for subsequent transmission 

• Retrieving messages already queued for 
transmission to terminals 

9 For outgoing messages, performing mes¬ 
sage editing functions such as: plac¬ 
ing time-sent and date-sent information 
in the header; placing an output 
sequence number in the header; logging 
the outgoing message on a secondary 
storage device; maintaining a count of 
the number of messages sent to each 
terminal; and translating the message 
from EBCDIC code to the appropriate 
transmission code 

® Taking periodic checkpoints of the sys¬ 
tem* in which the status of the queues 
and the telecommunications network are 
saved on a direct access storage 
device* This information can be uti¬ 
lized by a recovery facility (Restart) 
in case of subsequent system failure 

® Providing operatcr-to-system communica¬ 
tion through a telecommunications sys¬ 
tem control terminal 

® Providing on-line terminal testing for 
remote IBM terminals 

a Keeping counts cf line errors 

• Providing errcr recovery procedures. 


For audio terminals, the primary capabi¬ 
lities of the telecommunications programs 


that can be created through the use of QTAM 
macro instructions are: 


® Enabling audio communication lines 


® Receiving messages from terminals 


® Sending audio messages to terminals 

a Providing main storage for DCV word 
buffering, when an IBM 7772 uses DCV 
words dynamically retrieved from DASD 

® Performing, for incoming messages*, mes¬ 
sage editing functions such as: trans¬ 
lating from the transmission code in 
which messages are received into 
extended binary coded decimal inter¬ 
change code (EBCDIC), except for the 
messages dialed on IBM 3944; inserting 
time-received information when messages 
are to be logged on a secondary storage 
medium such as magnetic tape 

® Queuing messages on the main storage 
process queue 

• Initiating corrective action when an 
error or an unusual condition has been 
detected 

• Providing messages to a message proces¬ 
sing program 

® Placing response messages in queues for 
subsequent transmission 

• Retrieving messages previously queued 
for transmission 

® Keeping counts of audio line errors 

® Providing error recovery procedures. 
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NONAUDIO MESSAGE HANDLING 


The following sections describe message 
control services for networks designed to 
handle ncnaudio messages only. For a dis¬ 
cussion of audio message handling and of 
mixed audio and ncnaudio message handling, 
refer to page 117 • 


MESSAGE FORMATS (NCNAUDIO MESSAGES) 


This section describes the format cf 
ncnaudic messages. For a detailed discus¬ 
sion of the formats cf messages arriving 
from various terminal types,, these in 
storage* and these being transmitted to 
various terminal types, refer tc Appendix 
J. 

A ncnaudio message usually consists of 
two parts: header and text. The message 
header contains control information fer the 
message* such as: 

1. Cne or more destination codes. 

2. The code name fer the originating 
terminal. 

3. The number of the message relative to 
the numbers cf previous messages 
received from that terminal (input 
sequence number). 

4. A message type indicator. 

5. Various ether fields containing con¬ 
trol type data. 

Operations cn the fields in the header 
are a primary function of the LFS-defined 
routines in the message control program. 

The length and format of the header and the 
information it contains depend solely on 
the requirements cf the application and the 
user's preferences. The length may be just 
a few characters cr many characters. In 
seme instances, it is possible to omit hea¬ 
ders entirely; however, some type of header 
is usually provided. The text portion of a 
message consists cf the information cf ccn- 
cern tc the party ultimately receiving the 
message. This party can be either a termi¬ 
nal or a program that processes the text 
(message processing program). 

The format cf the message header* to a 
great extent, dictates the arrangement of 
the message ccntrcl program. Fer this 
reason, the ccntrcl characters used and the 
sequence of the fields within the header 


must be predetermined so that the message 
control program for the telecommunications 
system can be properly coded. 

The destination codes in the message 
header identifies the terminal(s) or pro¬ 
cessing program to which the message is to 
be routed. The message type indicator can 
be used to identify a header that is to be 
processed in a special manner. By insert¬ 
ing certain macro instructions in the mes¬ 
sage control program, the user can insert 
in the header such data as the date and 
time the message is received* the date and 
time it is sent, and the number of the mes¬ 
sage in relation to other messages sent to 
a particular terminal (output sequence 
number). 

Depending on the type of work unit (mes¬ 
sage, segment, or record) with which he is 
dealing in his system, the user must speci¬ 
fy appropriate characters for control 
purposes. 

® A message is that unit of text that is 
terminated by a special end of trans¬ 
mission (EOT) character or by an EOM or 
EOT character for WTTA terminals. 

® A segment is that portion of a message 
contained in a single buffer, the size 
of which is specified by the user. 

• A reqord is that portion of a message 

terminated by any of the following 
characters: end of block (EOB)* end- 

of-text (ETX), carriage return (CR) W 
line feed (LF), or new line (NL). 

• A message block is that portion of mes¬ 
sage terminated by an EOB character. 
There is no EOB character for WTTA 
terminals. 

Note: The end of an input message sent 
by a WTTA terminal is indicated by one 
of the following: 

• EOM character: indicates that 
another message is to be sent by the 
terminal operator. 

• EOT character: indicates that the 
input message is the last to be sent 
by the terminal operator. 

• A time-out: indicates that no char¬ 
acter has been sent by the terminal 
operator during a 28-second inter¬ 
val. This is recognized as an end- 
of-transmission signal. 
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Figure 3. Sample Fermat for an Outgoing Message 


There are many possible variations for 
the format of a message header. The sample 
formats shown in Figures 2 and 3 are 
included for illustrative purposes. 

The format shewn in Figure 2 could be 
used in a message switching application. 
Eyte 0 contains a machine end of address 
(EOA) character. There is no machine EGA 
character for WTTA terminals, When the 
message is transmitted, this character sig¬ 
nals the end of ncnrecorded machine control 
characters (such as addressing characters 
and the machine ECA itself) and the begin¬ 
ning cf data characters. The 192 in bytes 
1 through 3 is the input sequence number. 
Eytes 5 through 7 contain the code for the 
terminal that originated the message. 

Bytes 9 through 11 and 13 through 15 con¬ 
tain destination codes specifying the ter¬ 
minals to which the message is to be sent. 
In this example, the semicolon in byte 16 
has been designated by the user as the pro¬ 
gram EGA character. Since some of the mes¬ 
sages in this application contain multiple 
destination codes, this control character 
must fellow the last destination code. 

Bytes 17 and 18 contain characters specify¬ 
ing the priority cf the message. The 
remaining portion of the message is text 
and is followed by the EOT character. 

After the message control program has 
operated on the message header and before 
the message is transmitted to the destina¬ 
tion terminals, the format of the message 


could be as shown in Figure 3. When the 
message comes into main storage* the mes¬ 
sage control program inserts time received 
and date received information in the head¬ 
er. The time received information in bytes 
18 through 25 indicates that the message 
was received at 11 hours* 30 minutes,,, and 
45 seconds on the date (November 5, 1966) 
specified in bytes 27 through 34. Inser¬ 
tion of this information moves the priority 
data to bytes 35 and 36. The message is 
then queued by priority on the direct 
access storage device. When the message 
reenters main storage prior to transmission 
to the destination terminals* the message 
control program places the output sequence 
number in bytes 38 through 40 of the head¬ 
er. The original text and the EOT charac¬ 
ter follow the output sequence number. 


QTAM, with its complete set of header 
processing routines and associated macro 
instructions,, allows the user to indicate 
the header processing functions he wishes 
performed. He does this by including the 
appropriate macro instructions in the mes¬ 
sage control program. Many functions are 
available* in addition to those described 
briefly in this section, such as the detec¬ 
tion of incorrect or invalid information in 
the header fields. These functions and the 
relationship of the message header format 
to the design of the message control pro¬ 
gram are discussed in detail in later sec¬ 
tions of this publication. 
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NCNAUEIC MESSAGE FICW 


The iressage flew within the systeir 
depends on the type cf iressage. This sec¬ 
tion describes the flow of nonaudio mes¬ 
sages through a systeir operating under DCS 
QTAM from the receipt of the iressage at the 
computer to its transmission to a destina¬ 
tion terminal. Figure 4 illustrates this 
message flow. 

The input message is prepared at the 
remote terminal location. Messages may be 
of variable length and consist cf two 
parts: header and text. When polled, the 
source terminal sends the message to the 
computer via a communication line* In 
Figure 4, step 1 shews the message passing 
through an IEM 2701, 2702, or 2703 control 
unit and the multiplexer channel, and 
filling available buffers from the QTAM 
buffer pool. 

The user defines the size of his buffers 
in the message control program, which must 
be in the foreground-one partition. QTAM 
inserts control information (knewn as a 
prefix) in the first portion of each buff¬ 
er. The first 32 bytes of a buffer used to 
contain a message header are set aside fer 
a header prefix generated by QTAM. This 
buffer must contain the entire header and 
may also contain text data. The characters 
transmitted by the remote terminal begin 
filling the buffer in byte 32. The first 
22 bytes of a buffer used to contain only 
text data are set aside for a text prefix 
generated by QTAM• Message data begins 
filling the buffer in byte 22. 

The user can transmit single segment or 
multisegment messages. (A message segment 
is that message data that occupies one 
buffer.) In single segment messages, the 
entire message is contained within one 
buffer. In multisegment messages, more 
than cne buffer is needed for a message. 

In all buffers except the last for a 
multisegment message, the segment contain¬ 
ing the header is shorter than a segment 
containing only text; this is because the 
header prefix generated by QTAM is ten 
bytes longer than the text prefix. In each 
buffer used to contain intermediate text, 
the segments are the same size. In the 
last buffer fer a multisegment message, the 
message segment can be any length equal to 
or less than the buffer length minus 22. 

The buffers shewn in Figure 4 are each 
80 bytes in length. The first input buffer 
thus accommodates a message segment of 48 
characters; of these, 26 constitute the 
header portion cf the message and 22 the 
text portion. In the second input buffer. 


the message segment is 58 characters; all 
of these characters are text data. The 
third and last input buffer contains the 
remaining characters in the message. Since 
the input message is 150 characters* the 
message segment size for this buffer is 44. 

As soon as a buffer is filled with the 
first segment of a message, a portion of 
the line procedure specification (LPS) 
called the receive group performs such 
user-selected functions as: converting 
codes, logging, updating message counts* 
incorporating time-received and date- 
received information, and checking input 
sequence numbers. The first three func¬ 
tions can also be performed for text seg¬ 
ments. In Figure 4, the user has specified 
that messages to be handled by a message 
processing program must have six characters 
of time-received information incorporated 
into the message header. The header infor¬ 
mation preceding the position where the 
time is to be inserted is shifted into the 
reserved area in the header, and the time 
is inserted into the space thus created. 

The insertion of additional fields in the 
header must not cause the header and prefix 
size to become greater than the specified 
buffer size. 

In performing its function* the LPS 
scans and processes header fields in accor¬ 
dance with the order indicated by the rela¬ 
tive positions of the individual LPS macro 
instructions; the operations are performed 
in the buffer containing the message seg¬ 
ment. After performing these functions* 
the receive group of the LPS routes the 
prefix (minus the first eight bytes*-) and 
the message segment to either a DASD 
destination queue or a DASD process queue. 

Each DASD destination queue contains 
message segments that are to be transmitted 
via a certain line, or message segments 
that are to be transmitted to a certain 
terminal. A DASD process queue contains 
message segments that are to be routed to a 
message processing program. 

The receive group of the LPS can check 
the validity of the name of the originating 
terminal and the destination code before 
routing the message to a DASD process queue 
or DASD destination queue. Each type of 
queue is maintained on a direct access 
storage device, and all such queues are 
regarded as one file (the DASD message 
queues file). 


*-The first eight bytes of a header or text 
prefix contain control information used 
only in main-storage buffer handling; 
therefore, these bytes are not placed on 
the direct access device. 
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Figure 4. C1AK Message Flow (Fart 1 of 2) 
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Each EASE process queue is associated 
with a message processing program. Mes¬ 
sages requiring text processing should be 
routed to the CASE process queue associated 
with the message processing program that 
processes that type of message. The user 
contrcls this routing either via the mes¬ 
sage header (the destination code is the 
name of the DASD process queue) or by LPS 
macro instructions that direct messages of 
a particular type to a particular queue. 
Step 2 of Figure 4 shows the IPS routing a 
message to a DASD process queue. The 
receive group of the IPS can place messages 
that do not require text processing (e.g. ? 
switched messages) directly on the appro¬ 
priate DASD destination queues. 

For each CASE process queue maintained* 
QTAM maintains a corresponding queue in 
main storage. Each main storage (MS) pro¬ 
cess queue is maintained in buffers from 
the QTAM buffer peel in the foreground-one 
partition. The number of buffers allocated 
to an MS process queue is specified in a 
DTF table by a message processing program. 
After the DTF table for the MS process 
queue has been opened by the message pro¬ 
cessing program* a QTAM routine automatic¬ 
ally passes the message segment from the 
DASD process queue to the MS process queue 
(see Step 3 of Figure 4). In moving the 
prefix and the segment to the buffer, the 
eight bytes that were deleted when the pre¬ 
fix and the segment were placed on the DASD 
process queue are restored so that the pre¬ 
fix length is once again 32 (header prefix) 
or 22 (text prefix). 

Each time the message processing program 
gains control and issues a GET (Step 4 in 
Figure 4), QTAM passes message data from 
the MS process queue to a user-specified 
work area in the message processing pro-* 
gram. Message data is provided in the work 
unit specified by the user in the DTF 
table. The work unit may be either a com¬ 
plete message, a message segment, or a 
record. Before moving the message data to 
the work area, QTAM strips the header and 
text prefixes from the message segments. 

In the first four bytes of the work area,, 
QTAM places a 4-byte prefix,, which indi¬ 
cates the size and type of work unit with 


which the user is dealing.. After receiving 
the message data, the message processing 
program processes it as required by the 
application. 


A message processing program generating 
a response message must define and open a 
DTF table governing message transfer before 
attempting to place the message on a DASD 
destination queue. This DTF table contains 
information needed by QTAM to establish an 
MS destination queue. When a PUT macro 
instruction is issued by a message proces¬ 
sing program (Step 5 in Figure 4)* QTAM 
moves the message data from the user- 
specified work area into the MS destination 
queue. The header and text prefixes are 
attached to the message segments in the 
buffer areas that make up the MS destina¬ 
tion queue. As the message data fills the 
buffers,, QTAM inserts chaining addresses 
and other necessary control information 
into the prefix fields. The response mes¬ 
sage generated by a message processing pro¬ 
gram can be any size (the one used in 
Figure 4 is 120 characters!. 

After the header and text prefixes have 
been added in the MS destination queue, 

QTAM places the message into the appropri¬ 
ate DASD destination queue on the DASD mes¬ 
sage queues file (Step 6 of Figure 4). 

QTAM retrieves message segments from the 
DASD destination queues on a first-in- 
first-out basis within priority groups. 

The message segments are brought in from 
the direct access device and placed in 
available buffers (Step 7 of Figure 4). 

The send group of the LPS section in the 
message control program can then perform 
such user-rselected functions as: convert¬ 
ing the code of the message to the device 
code of the terminal, incorporating time- 
sent and date-sent information in the head¬ 
er, message logging, and updating of mes¬ 
sage counts. These operations are per¬ 
formed in the buffers that receive the mes¬ 
sage segments from the direct access 
device. QTAM then strips the header and 
text prefixes from the message segments and 
transmits the message to the appropriate 
terminal (Step 8 of Figure 4),. 
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The header and text prefixes described 
in this section are generated automatically 
and are used by QIAN routines. No program¬ 
ming considerations are required by the 
user for the manipulation of the buffers 
and their prefixes as messages flow through 
the system. The header and text prefixes 
are discussed cnly tc give a complete 
description of the flew of messages through 
the system. A macro instruction is pro¬ 
vided that allows the user to retrieve mes¬ 
sages from a queue on the DASE message 
queues file. When this macro instruction 
is used to retrieve the segment containing 
the message header cf a multisegment mes¬ 
sage, the user can access the chain address 
field in the header cr text prefix to 
retrieve succeeding segments cf the mes¬ 
sage. The formats of the header and text 
prefixes are shewn in Appendix A. 


RELATIVE PRIORITY Cf RECEIVING VERSUS 
SENEIRG IR RORflUEIC CPERAUORS 


Message traffic can proceed in only one 
direction at a time ever each of the half- 
duplex lines that comprise a GTAM- 
controlled telecommunications network. 

The user has the option of specifying, 
fer each line greup made up of nonswitched 
lines, one of three relative priorities cf 
receiving versus sending operations for the 
lines in the group. He may specify that 
receiving has priority over sending, the 
two have equal priority, or sending has 
priority over receiving. The significance 
of these options varies with the type of 
polling process. For lines polled under 
the control of the program capability 
(polled lines), the implications are as 
follows. 

If receiving has priority ever sending, 
polling cf terminals and receipt of incom¬ 
ing message traffic proceed continuously on 
a given line except during the time period 
that a user-specified polling interval is 
observed. The specified polling interval 
is observed only when no message traffic is 
received during a complete pass through the 
polling list for the line. Outgoing mes¬ 
sages (if any are present on the destina¬ 
tion queue for the terminal or line) are 
sent only during this interval, and cnly 
until the interval expires. Upcn expira¬ 
tion cf the interval, outgoing message 
transmission ends after the current message 
is sent, regardless of whether any messages 
still remain queued. Polling and incoming 
message transmission then resume. It is 
important to note that if no polling inter¬ 
val is specified, or if there is no lapse 
in incoming message traffic, outgoing mes¬ 
sage transmission cannot occur. Assuming 


that the user specifies a polling interval, 
he must also make it long enough to accom¬ 
modate any expected density of outgoing 
message traffic. In other words, too short 
an interval will cause outgoing messages to 
"back up" on the destination queue for that 
terminal or line. 


If receiving and sending have equal 
priority, polling and incoming message 
traffic proceed without interruption until 
all terminals on the line have been polled 
(i.e., until the end of one polling pass). 
Then outgoing messages (if any are present 
on the destination queue for the terminal 
or line) are sent. Once outgoing message 
transmission begins,, it continues until all 
messages on the queue have been sent, 
regardless of whether the user has speci¬ 
fied a polling interval. When the destina¬ 
tion queue is depleted, polling and incom¬ 
ing message traffic resume. Note that, in 
contrast to the case where receiving has 
priority, outgoing message transmission 
occurs whether or not a polling interval is 
specified and regardless of the length of 
the interval. 


If sending has priority over receiving, 
outgoing messages (if any are present on 
the destination queue) are sent: 

1. Each time a negative response to pol¬ 
ling is received from a terminal. 

2. Each time an EOT is received from a 
terminal, indicating that a complete 
message has been sent. 

Once outgoing message transmission 
begins, it continues until all messages on 
the queue have been sent. Note that when 
sending has priority, outgoing transmission 
can occur after each terminal is polled, 
rather than only after a complete polling 
pass. 

For lines polled under the control of 
the Auto Poll feature (autopolled lines), 
the priority options of receiving over 
sending have the following meanings. 

If receiving has priority over sending, 
no outgoing messages can be sent to the 
terminals attached to these autopolled 
lines* The lines are open to incoming mes¬ 
sages traffic only. 

If receiving and sending have equal 
priority, the significance of this option 
for autopolled lines is the same as for 
polled lines with the exception that no 
polling interval may be specified* 

If sending has priority over receiving, 
outgoing messages are sent: 
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. Each time an EOT is received from a 
terminal* indicating that a complete 
message has keen sent by this 
terminal. 

2. Each time the end of the polling list 
is reached. 


MANAGEMENT OF WTTA LINES 


The name World Trade telegraph terminal 
(WTTA terminal) refers to any of various 
European teletypewriters using a start-stop 
5-level code with two shifts (letters shift 
and figures shift) tc transfer data over 
leased point-to-point telegraph lines 
(referred to as WTTA lines) at 50, 75, or 
100 bauds (bits per second). The codes 
used are either the International Telegraph 
Alphabet No. 2 (referred to as ITA2) or the 
Figure Protected Code ZSC3 (referred to as 
ZSC3)• These two codes are illustrated in 
Figures 44 and 45. 

WTTA lines operate in a contention sys¬ 
tem. The message control program is always 
ready to handle messages from WTTA ter¬ 
minals since, as scon as traffic ceases, a 
Read operation is initiated so that the 
line is prepared to receive the next mes¬ 
sage. Therefore, only one WTTA terminal 
can be connected tc a given WTTA line. 

A message sent to a WTTA terminal (out¬ 
put message) or sent by a WTTA terminal 
(input message) must always start with 
twelve ITRS characters. For an input mes¬ 
sage, these twelve characters are sent by 
the terminal operator, but they do not 
enter main storage. For an output message, 
they are automatically sent by QTAM. When 
input messages are prepunched into paper 
tape, the 12 ITRS characters are required. 
On the other hand, the WRU f EOM , and EOT 
characters must never be prepunched; they 
roust be sent by the operator. 

The user can specify that receiving has 
priority over sending, that sending has 
priority over receiving, or that the two 
have equal priority. If receiving has 
priority over sending, (or if the two have 
equal priority), and if there is no traffic 
over the line, the corresponding Read com¬ 
mand is interrupted and an output message 
is sent to the WTTA terminal (refer to the 
note below). If an input message is being 
received, the output message will be sent 
only after an EOT character has been 
received or after a time-out has occurred. 
If sending has priority over receiving, the 
same procedure is followed, except when an 
input message is being received; in this 
case, the output message will be sent as 
soon as an EOF or EOT character is received 
or a time-out occurs. 


Note: If the first character of an input 

message is received at the same time the 
Read command is interrupted, the output 
message is not sent and the input message 
is accepted. 

Both the CPU and the WTTA terminal can 
ask for the identification sequence of the 
other. When an identification exchange is 
performed, the CPU sends its identification 
sequence to the terminal (IAM=YES must be 
specified in the DTFQT macro instruction), 
and the terminal sends its identification 
sequence to the CPU (WRU=YES must be speci¬ 
fied in the DTFQT macro instruction).. An 
identification exchange can be performed 
during either 

• Receiving operations, each time the 
terminal operator sends the WRU signal 
to the CPU; or 

• Sending operations, at the beginning of 
an output message (if the WRU macro 
instruction is in the Send Header sub¬ 
group of the LPS) or at the end of an 
output message (if the WRU macro 
instruction is in the End Send subgroup 
of the LPS). 

When the CPU receives the terminal identi¬ 
fication sequence, QTAM compares this 
sequence with that specified in the TERM 
macro instruction (refer to the description 
of the TERM Macro Instruction). 


MANAGEMENT OF NONAUDIQ SWITCHED LINES 


Insofar as possible, QTAM management of 
switched lines parallels the management of 
nonswitched lines. A number of differences 
should be understood, however. 

In a switched network, terminals are not 
attached to the computer by specific lines. 
Rather a line connection between the com¬ 
puter and a terminal is established over 
any available access line included in the 
line group. An available line is a line 
over which message traffic is not currently 
in progress. 

The management of switched lines by QTAM 
allows all current message traffic (both 
from CPU to terminal and from terminal to 
CPU) to be transmitted during one call. 

That is, once a line connection is estab¬ 
lished by either party, all messages queued 
for sending to the terminal are sent, and 
the terminal is allowed to send to the com¬ 
puter all messages it may have ready. The 
priority scheme implemented for switched 
lines is similar to the sending priority 
previously described for nonswitched lines. 
That is, each time a message is received 
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from a terminal, any messages on the 
destination queue for the terminal are sent 
before accepting another message from the 
terminal. This is true regardless of 
whether the line connection is caused by a 
computer initiated call or by a terminal 
initiated call. The primary reason for 
handling switched lines in this manner 
(rather than requiring separate calls for 
incoming and outgoing messages) is in the 
interest of economy since the rates for a 
switched network are frequently on a per 
call basis. 


CALLS FROM THE COMPUTER TO A SWITCHED 
TERMINAL 


The Auto Call feature is required for 
computer initiated calls to a terminal on a 
switched network. This discussion assumes 
that this feature is included and that com¬ 
puter initiated calls are desired. 

When messages appear on a destination 
queue for any type cf terminal cn a 
switched network, the computer attempts to 
find an available access line starting with 
the relative line defined in the terminal 
table entry fcr that terminal. If that 
access line is busy and additional lines 
were defined in the line group, the comput¬ 
er attempts to initiate the call using one 
of these lines. If all the defined lines 
are busy, the attempt to call the terminal 
is deferred until a line becomes available. 
When an available access line is found, the 
computer disables the line and dials the 
terminal using the dial digits specified in 
the terminal table entry. If the dialing 
procedure is completed successfully and if 
the terminal is ready to receive, the 
queued messages are sent. (If the dialing 
procedure is not completed or if the com¬ 
puter receives a negative response to 
addressing, the messages are not sent 
unless the user includes INTERCFT and 
RELEASEM macro instructions to cause later 
sending of the messages. See the descrip¬ 
tions of these macro instructions.) After 
all messages are sent to the terminal, the 
computer turns the line around and accepts 
any incoming messages the terminal may have 
ready. If further messages arrive cn the 
destination queue for the terminal while 
the computer is accepting an incoming mes¬ 
sage, these messages are also sent before 
another message is accepted from the termi¬ 
nal. When the last incoming message is 
received and no further messages appear on 
the destination queue, the computer breaks 


the line connection (for the 2740„ the con¬ 
nection must be broken at the terminal). 

It then reenables the access line, making 
that line available again. 

Restriction : A terminal on a switched line 
not having the Auto Call feature can 
receive a message only in response to an 
inquiry when the line is operating in con¬ 
versational mode. A message cannot be 
switched to this terminal from another 
terminal. 

For a discussion of calls from computer 
to switched IBM 1050, IBM 2740, and TWX 
terminals,, see Appendix J. 


CALLS FROM A SWITCHED TERMINAL TO THE 
COMPUTER 


The Auto Answer feature is required for 
the terminal initiated calls to the comput¬ 
er on a switched network. This discussion 
assumes that this feature is included and 
that terminal initiated calls are desired. 

When QTAM is not sending messages to or 
receiving messages from a switched terminal 
over a particular access line, that line is 
enabled to permit switched terminals to 
call the computer. A terminal that wishes 
to send a message causes a line connection 
to be established by dialing the computer 
over an enabled line. After answering the 
call, QTAM receives the first incoming mes¬ 
sage (if any) from the terminal and then 
sends any messages on the destination queue 
for the terminal. From this point, the 
transmission of further messages between 
the terminal and the CPU proceeds in the 
same sequence described for computer 
initiated calls. When the terminal indi¬ 
cates that it has no more messages and no 
further messages appear on the destination 
queue for the terminal, QTAM breaks the 
line connection and reenables the line. 
(With the 2740, the connection roust be bro¬ 
ken at the terminal). 

Except that the first message is sent by 
the terminal, the receiving and sending 
procedures for a terminal initiated call 
from either an IBM 1050, IBM 2740, or a TWX 
terminal are identical to those described 
in f Calls from the Computer to a Switched 
Terminal•. 

For a discussion of IEM 2260-2848 Local 
Operations, refer to Appendix J. 
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TELECOMMUNICATIONS APPLICATIONS (NQNAUDIO) 


A telecommunications systeir operating 
under DCS/QTAM can be designed for a vide 
variety of applications including message 
switching* collecting data* standard audio 
answering* processing collected data,* and 
inquiry processing. Each of these applica¬ 
tions is described here briefly. 


MESSAGE CONTROL APPLICATIONS 


Three applications particularly suited 
to handling by a message control program 
are message switching* data collection,* and 
standard audio answering (the last of these 
is described in the audio secticn of this 
publication). 


MESSAGE SWITCHING 


Message switching can be accomplished 
entirely within the message control program 
except that a message processing program 
must be loaded and initiated to terminate 
the execution of the message control 
program,. 

In a message switching application,* ter¬ 
minals transmit messages to the central 
processing unit* which relays the messages 
to cne cr more ether terminals. The appli¬ 
cation does not prevent a terminal from 
sending a message to be processed. QTAM 
places these messages on a DASD process 
queue for handling by a message processing 
program (either concurrently or at a later 
time). 

When an incoming message is to be 
switched* the IPS section of the message 
control program rcutes the message to a 
DASD destination queue. If desired* infor¬ 
mation such as the time and date of receipt 
can be placed in the message header. Vali¬ 
dating the codes cf the originating and 
destination terminals and checking the 
input sequence number in the header can 
also be performed. Eefore a message is 
transmitted to its destination,* the IPS can 
record in the header the date and time the 
message is sent. It also can record the 
number cf the message in relation to other 
messages sent to that terminal. The IPS 
can also log the messages sequentially on a 
storage device for subsequent reference by 
the user with a different access method. 


DATA COLLECTION 


Data collection* like message switching,* 
can be accomplished entirely within the 
message control program except that a mes¬ 
sage processing program must be loaded and 
initiated to terminate the execution of the 
message control program. 

In a data collection application,, ter¬ 
minals send data in the form of messages to 
the central processing unit (CPU)„ The 
messages are accumulated and stored by the 
CPU,* and subsequently processed as a batch. 

The message control program can accumu¬ 
late data in two ways: 

1. It stores the data on DASD process 
queues. 

2. It can also store the data on any 
secondary storage medium. 

If the first method is used* the messages 
can be obtained at any time (concurrently 
or later) by a message processing program 
(see the subsequent section Processing 
Collected c Data ). The messages are routed 
to DASD process queues on the DASD message 
queues file in the same manner as any other 
messages that have a message processing 
program as their destination. The messages 
remain on these DASD process queues until 
the activation of a message processing pro¬ 
gram which issues a series of GET macro 
instructions to obtain and process the 
messages. 

In the second method* the LOGSEG macro 
instruction in the LPS section of the mes¬ 
sage control program causes the message to 
be recorded sequentially on a secondary 
storage device selected by the user. An 
access method other than QTAM must be used 
to retrieve these messages for processing. 


MESSAGE PROCESSING APPLICATIONS 


A wide variety of telecommunications 
applications can be processed by a message 
processing program. Two of these applica¬ 
tions are: 

• Processing collected data (not applica¬ 
ble to the audio messages). 

• Inquiry processing. 
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PROCESSING COLLECTED DATA 


The processing cf collected data is the 
second part of a 2-step application* The 
first step is the actual collection of the 
data fcy a message control program (see the 
preceding Data Ccllection discussion). 

The message ccntrcl program places data 
to fce collected on DASD process queues and 
optionally on any secondary storage device 
(through the LOGSEG macro instruction). 
These messages may fce retained cn the 
storage device used until it is convenient 
to process them. 

If messages are collected cn a DASD pro¬ 
cess queue,* they remain cn the queue until 
a message processing program issues GET 
macro instructions tc obtain and process 
the messages. The message processing pro¬ 
gram that processes the collected data can 
either: 

1. Ee operated concurrently with the 
collection cf the data fcy the message 
control program , or 

2. Ee loaded and initiated at a later 
time (for example* to process data at 
the end of the day after all message 
traffic has ceased). 

In the latter case* if the user wishes 
to have QTAM retrieve the messages from the 
DASD process queue* the message control 
program roust remain operational. If ter¬ 
mination cf the message control program is 
desired so that the foreground 1 partition 
is available for another program* the mes¬ 
sage processing program must implement 
another access method tc perform the input 
operations. 

if the data is collected on a user 
selected secondary storage device by a LCG- 
SEG macro instruction, the data must fce 
obtained for processing fcy an access method 
other than QTAM. 


INQUIRY PROCESSING 


An inquiry application involves receiv¬ 
ing messages from terminals (performed by 


the message control program)* processing 
the data contained in the messages (per¬ 
formed by the message processing program ) v 
and sending replies to the originating ter¬ 
minals (message control program). 


The routines called by the message pro¬ 
cessing program to process the messages 
need not reside in main storage. For 
example* in an inquiry processing applica¬ 
tion that requires processing of many dif¬ 
ferent types of inquiries*, it may not be 
economical to have all of the required pro¬ 
cessing routines in main storage. The mes¬ 
sage processing program can contain an ana¬ 
lysis routine that determines the type of 
the message and loads the routine required 
to process it from the core image library 
(via a FETCH or LOAD macro instruction). 

The routines fetched dynamically in this 
manner must have previously been linkage- 
edited onto the core image library at a 
specified address in an available area in 
the partition in which the message proces¬ 
sing program is executing* 


An optional feature of the inquiry app¬ 
lication is operation in a conversational 
mode. 


For nonaudio lines operating in conver¬ 
sational mode* a terminal transmitting a 
message into the system is held on the line 
by the message control program until the 
message processing program generates a 
response message for transmission back to 
the inquiring terminal. The response mes¬ 
sage is transmitted immediately. Conversa¬ 
tional mode is specified through the CON¬ 
VERSE operand of the MODE macro instruction 
in the LPS section of the message control 
program. Another optional function parti- 1 
cularly suited for a high volume inquiry 
application is specified by the EXPEDITE 
operand of the PROCESS macro instruction in 
the message control program. The EXPEDITE 
operand causes messages to be routed 
directly to the main storage process queue 
associated with the message processing pro¬ 
gram. The normal intermediate step of 
placing the messages on a DASD process 
queue is therefore bypassed. Both of these 
optional functions decrease the time 
required to return an answer to the inquir¬ 
ing terminal. 
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MESSAGE CCNTBCL PBCGRAM (NONADDIC MESSAGES) 


In every telecommunications systeir using 
QTAM, there must he one message control 
program. The message control program must 
be executed in the foreground 1 partition 
of the Disk Operating System, fcith multi¬ 
tasking, the message control pregram must 
be executed as the highest priority task in 
the fcreground-cne partition* 

For nenaudio lines, message control 
includes those functions that: 

1. Control the flew of messages between 
the computer and terminals. 

2. Prepare the messages for processing 
and route them tc their destination 
(another terminal or a message pro¬ 
cessing pregram). 

3. Frcvide the user with statistical in¬ 
formation relating to message traffic. 

4. Provide the user with a copy of mes¬ 
sages received from or sent to 
terminals. 

The message control program includes 
both device handling and message handling 
routines of QTAM. Messages arriving at the 
computer frem terminals are coded in the 
transmission code cf the particular termi¬ 
nal. Facilities are provided tc convert 
these transmission cedes to the extended 
binary coded decimal interchange code 
(EECDIC), which simplifies message analy¬ 
sis. Similarly, messages being sent from 
the computer to a terminal are converted 
from EBCDIC to the transmission code of the 
terminal. Refer tc Appendix J for a dis¬ 
cussion of considerations for specific 
terminals. 

Messages received from terminals can be 
routed tc one or more destinations. QTAM 
routines check the validity of the destina¬ 
tion codes and place messages in DASD 
queues according tc their destinations. 

From these DASD queues, the messages are 
normally sent tc their destinations on a 
first-in-first-out basis, however, a mes¬ 
sage priority scheme may be included to 
expedite the handling of certain messages. 
Priority processing cf messages is particu¬ 
larly useful in an application, such as 
inquiry processing, where rapid response to 
inquiries is required. 

The input messages are normally sent to 
the MS process queue of the corresponding 
message processing program on a first-in- 
first-cut basis. 


To construct his message control pro¬ 
gram, the user must select, place into 
order, and assemble macro instructions pro-* 
vided by QTAM. There are four major sec¬ 
tions in the message control program and 
each can be wholly defined by QTAM macro 
instructions. The four major sections and 
the order in which they will be discussed 
are: 


1. File definition. 

2. Control information. 

3. File initialization and activation. 

4. Line procedure specification. 


File definition and control information 
macro instructions generate the tables, 
lists, and buffer areas needed in the sys¬ 
tem. Initialization and activation macro 
instructions ready the system for 
operation. 

The line procedure specification (LPS) 
section is the most important section of 
the message control program. In the LPS 
section, the user specifies, through LPS 
macro instructions, the manner in which he 
wishes message traffic in his system to be 
handled. The LPS macro instructions estab¬ 
lish the linkage to QTAM routines that per¬ 
form the message code translating, editing, 
error checking, logging, and routing func¬ 
tions,, The parameters used by these rou¬ 
tines originate either in the message head¬ 
er or in the LPS macro instructions sup¬ 
plied by the user. 

The information specified in the file 
definition and control information sections 
is also used by the LPS routines in per¬ 
forming their functions. There must be one 
LPS for each communication line group that 
requires different message handling 
functions. 

QTAM provides DSECTs (see Figure 5) that 
enable the user to refer symbolically to 
the various fields in the tables and con¬ 
trol blocks used by QTAM. Three such 
DSECTs are automatically generated in the 
message control program: 

1. Terminal table entry DSECT (includes 
names assigned to an optional subfield 
by the user in OPTION macro instruc¬ 
tions). This DSECT is always 
generated. 
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2. Euffer prefix DSECT (header and text 
prefixes). 

3. line control block DSECT. 

If any other ESECT listed in Figure 5 is 
desired in the message control program, it 
can be included at assembly time by includ¬ 
ing a COPY statement with the name in the 
specify column cf Figure 5 in the operand 
field. If any DSECT is required in a mes¬ 
sage processing program* it can be included 
in the same manner (none of the DSECTs are 
automatically generated in a message pro¬ 
cessing program). It should be noted that 
all QTAN DSECT names have the fcur- 
character prefix, IJ1Q ; therefore, the user 
should refrain frcm using names beginning 
with these four characters. 



FILE DEFINITION 

A file definition macro instruction must 
be specified for each file referred tc by 
the message ccntrcl program, Fcur types of 
files are normally used: 

• Direct access message queues file, 

• Communication line group files. 

• Direct access checkpoint records file. 

• Message leg files. 


DIRECT ACCESS MESSAGE QUEUES FILE 


One direct access message queues file is 
required. Message segments awaiting trans¬ 
mission to destination terminals and mes¬ 
sage segments awaiting processing by a mes^ 
sage processing program are placed on 


queues on a direct access storage device 
(DASD)• (Multiple extents and multiple 
volumes may be used for the DASD message 
queues file,) To establish these queues 
(called DASD destination queues and DASD 
process queues, respectively)* one DTFQT 
macro instruction must be issued to define 
the DTF table for the file of message 
queues. The macro must specify *TYPE=DA*; 
however, the DLAB card creating the DASD 
label must specify type SD. 

Before defining and using the DASD mes¬ 
sage queues file,, the following steps must 
be performed: 

1. An area is allocated for the file on 
the DASD volume to be used, and 

2. The entire area allocated for the file 
is preformatted with dummy records. 

The dummy records must have a fixed 
length equal to the buffer size (as defined 
by the BUFFER macro instruction) minus 
eight. This formatting process is neces¬ 
sary only when the system is initially 
generated, not each time the message con¬ 
trol program is initiated. An access 
method other than QTAM must be used to for¬ 
mat the area for this file. Each extent 
formatted must have a format 1 label. The 
Clear Disk utility is recommended for 
formatting. 

The DASD message queues file is checked 
for incorrect formatting at the time the 
file is opened by an OPEN macro instruc¬ 
tion. If the file has been formatted inco¬ 
rrectly, an error message is provided and 
the job is cancelled. 


COMMUNICATION LINE GROUP FILES 


A communication line group file consists 
of messages transmitted via communication 
lines* or between the computer and a local¬ 
ly attached IBM 2260-2848 Display Complex. 
One or more files of this type are 
required. The user must specify one DTFQT 
macro instruction to define a DTF table for 
each line group in the system. 

A line group can consist of up to 31 
lines having the following common 
characteristics: 

• All lines in the group are of the same 
type, either switched or nonswitched. 

If switched, lines having the auto-call 
feature cannot be included in the same 
line group with lines not having the 
auto-call feature. If nonswitched, 
lines having the Auto Poll feature can¬ 
not be included in the same line group 
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with lines not having the Auto Poll 
feature. 


• Association with the same type of ter¬ 
minal devices (for example, all the 
lines connect IEM 1050*s to the system, 
or all the lines connect IBM 1030*s to 
the system). 


• Bequireroent that the same number of 
buffers he requested in advance for 
each transmission of data from a termi¬ 
nal to the computer. 


• Operation under the same relative 
priority specification. 


• Use of the same IPS. 


• Use of the same polling interval. 

Two additional requirements are: 

1. The relative position of the device 
access area in a terminal table entry 
must be the same for all terminal 
table entries associated with the 
lines in the line group (see the sec- 
ticn The Terminal Table ). 

2. No line within the line group can be 
defined as part of another line group. 

The requirements for defining an IBM 
2260-2848 Local line group are: 

• A ETFGT macro must be specified fcr each 
IBB 2848 Display Control. Mere than one 
2848 cannot be defined in the same line 
group. However, the same 2848 can be 
defined in mere than one line group. 

• No IBB 2260 Display Station cr 1053 
Printer within the line group can be 
defined as part of another line group,. 

• The same number of buffers must be 
assigned in advance for each transfer of 
data from a 2260 to the computer. 

• The same type of Bead operation must be 
used (Bead Display Station CBS] Manual 
Input (Mil or Short Bead (DS MI)for each 
2260 in the line group. 

• The same IPS roust be used for each 
device in the line group. 

• The relative position of the device 
access area in a terminal table entry 
must be the same for all terminal table 
entries associated with the line group 
(see the secticn The Terminal Table). 


DIBECT ACCESS CHECKPOINT RECORDS FILE 


The direct access checkpoint records 
file contains a record of the status of the 
queues and the telecommunications network. 
This information is written onto the DASD 
at user-specified intervals. Two such 
checkpoint records are maintained in the 
file along with a pointer to the most 
recent jrecord. One DTFQT maqro instruction 
is required to define the DTF table for the 
checkpoint records file. 

Before the checkpoint records file is 
defined, the following steps must be 
performed: 

1. An area is allocated for the file on 
the DASD volume to be used, and 

2. The area allocated for the file is 
preformatted by the user with one 
dummy record at the beginning of the 
file. 

The number of tracks required may be 
calculated from the formula: 

N = (288 ♦ 2.1(M)] 

3625 


where 

N = the number of tracks. Must be 
rounded to the next higher 
integer. 

M = the number of bytes in the check¬ 
point record. Must be the same as 
that specified in the SOWA operand 
provided checkpoint records. It 
may be computed by the formula 
provided in the description of the 
SOWA operand in Figure 7. 

The dummy record in the file must be 
four bytes in length, and the first byte 
must be binary 0. Formatting of other 
records needed is performed by the check¬ 
point routine. This formatting process is 
necessary only the first time this area is 
used, and not each time the message 
controlprogram is initiated. However, if 
the file has not been closed, because of a 
system failure, and the user does not wish 
to perform a restart operation, he roust 
reinitialize (reformat) this file before 
initiating the message control program. An 
access method or utility other than QTAM 
must be used to format the area for this 
file. 

The checkpoint records file is checked 
for incorrect formatting at the time the 
file is opened by an OPEN macro instruc¬ 
tion. If the file has been formatted inco- 
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rrectly, an error message is provided, and 
the jcfc is cancelled. 


MESSAGE LCG FILE 


A iressage log file consists cf messages 
that are stored and maintained sequentially 
on secondary storage for accounting pur¬ 
poses. A iressage log can be produced as a 
byproduct of ncrmal message handling. The 
appropriate DTFxx macro instruction must be 
specified for each message log required by 
the user. The ETFxx used depends on the 
secondary storage device emplcyed. Magnet¬ 
ic tape (DTFMT) is the storage medium gen¬ 
erally used. (Fcr a detailed discussion of 
the appropriate DTFxx macro instruction, 
refer tc the Supervisor and Input/Qutput 
M acros publication listed in the Preface .) 
The QTAM message control program employs 
logical ICCS tc reccrd the messages cn the 
leg. 


for each communication line group file* If 
the Checkpoint/Restart feature is desired,, 
a DTFQT macro instruction must be provided 
for the DASD checkpoint records file. At 
assembly time* DTFQT causes the allocation 
of main storage for a DTF table. Parame¬ 
ters based on the keyword operands speci¬ 
fied in the macro instruction are included 
in the DTF table. 


r - T - T - 1 

| Name]Operation|Operand | 

Y - T -+-^ 

|dtf ]DTFQT (keyword operands f 


dtf 

Is the name of the macro instruction. 
It is also the name of the DTF table 
generated by the expansion of the 
macro instruction. The name is speci¬ 
fied by from one to seven nonblank 
characters. The eighth byte of the 
name field is used by QTAM to indicate 
a 2311 or 2314 direct access device. 


FILE DEFINITION MACRO INSTRUCTIONS keyword operands 

Are the operands that can be included. 
The operands are separated by commas 

DTFQT M.acrc Instruction and are described for each type of 

file in Figures 6, 7„ and 8. 

One DTFQT macrc instruction must be spe¬ 
cified for the DASD message queues file and 
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r- 

| Keyword Operand 

l*- 

TYPE=DA 


I*- 

DEVAEER=SYSnnn 


SEPASM=YES 

SEPASM=NC 


| Value Eescription | 

| DA j 

| Identifies the file organization as that of the DASD message | 

j queues for telecommunications. j 

+- -J 

SYSnnn 


j Specifies the symbolic unit to be associated with this logicalj 

j file. If multiple volumes are used, only the symbolic unit j 

| for the first volume is specified. Actual units and channels j 

f are assigned to the file at job execution with appropriate | 

| ASSGN statements. The file is expanded to accommodate up to | 

j 16 extents. j 

| YES | 

j Specifies that this DTFQT is to be assembled separately from j 

the rest cf the user°s code. 


h- 

| ECJAD=relexp 


t---—- 

I[ DEVICE=2311 
| [DEVICE=2314 

l__ 


+ 


-+ 


NO | 

Specifies that this DTFQT is to be assembled with the rest of j 
the user°s code. NC is assumed if this operand is omitted. | 

relexp j 

Is the address of the instruction that begins a user-written j 
section of code that closes all files opened in the message j 
control program and performs other termination functions. j 

Refer to the section* Deactivating the Telecommunications Sys- j 

tern , for a discussion of the functions required in this user- j 
written section of code. j 


2311 

Specifies a 2311 direct access device. 

2311 is assumed if this operand is omitted. 

2314 

Specifies a 2314 direct access device. 


Figure 6. Keyword Operands for the DASD Message Queues DTFQT Macro Instruction 
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j Keyword Operand 


j Value Description 
| CK 

| Identifies the file organization as that of the checkpoint 
records fcr teleccirirunications. 


TYPE=CK 


DEV£EER=SYSnnii 


SYSnnn 

Specifies the symbolic unit to be associated with this logical 
file 


SEPASM=YES 

SEFASM=NC 


Specifies that this DTFQT is to be assembled separately from 
the rest of the user"s code. 


Specifies that this DTFQT is to be assembled with the rest of 
the user tt s code, KC is assumed if this operand is omitted. 


SCWA=m 


The number of bytes in the checkpoint record. It may be com¬ 
puted by the formula 

m = 17 + T + 11D + 14Q + 3R ♦ 9L ♦ P ± ♦ •,. + P n 
where: 

T = the number cf bytes in the terminal table* less four 
bytes for each terminal table entry* and not including 
the table control field, 

D = the number cf DASD destination queues, 

Q = the number cf DASD process queues. 

R = the number cf MS destination queues, 

L = the number cf lines. 

P ± +...+F n = the sum cf the sizes of the polling lists in 

bytes* less one byte for each polling position. 


DEVICE=2311 

DEVICE=2314 


2311 

Specifies a 2311 direct access device. 2311 is assumed if 
this operand is omitted. 

2314 

Specifies a 2314 direct access device. 


DQMAX=integer 


integer 

Specifies the number of destination queues for the processing 
program (i.e. t/ number of DTFDQ macro instructions issued in 
the processing program). If this operand is omitted* 2 is 
assumed. 


Figure 7. Keyword Operands for the Checkpoint Records DTFQT Macro Instruction 
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| Keywcrd Operand 

t--,- 

TYPE=LG 


j Value Description 




LG 


Identifies the file organization as that of a communication 
line group. 




CLPS=lpsname 


LINELST= 
(nnn,...) 


lpsname 

Is the name of the line procedure specification (LPS) section 
for this line group. This name must be identical to the name 
specified in the name field of the LPSTART macro instruction 
that begins the LPS section for this line group. 

nnn 

Specifies via a sutlist the correspondence between symbolic 
unit (SYSnnn) and relative line number. In the sublist„ the 
user codes one 3-digit number for each line in the line group. 
The 3-digit number is interpreted as the 'nnn* of SYSnnn. The 
order of ceding the 3-digit numbers determines which symbolic 
units are associated with the individual lines in the line 
group. As many as thirty-one 3-digit numbers from 000-244 may 
be coded in the sutlist. 

Example : LINELST-(005,010,007) This results in associating: 

SYS005 with relative line number 1, 

SYS010 with relative line number 2, 

SYS007 with relative line number 3, 

in a line group comprising three lines. The DTFQT macro 
expansion generates a Line Control Block (LCB) for each line 
defined in the sublist. Each LCB contains a command control 
block (CCE) and other information needed to control I/O opera¬ 
tions on the line. An actual unit and channel are assigned to 
the line at execution time by an ASSGN statement. 

This operand must be omitted when defining a line group for 
an IBM 2260-2848 Lccal. The symbolic unit assignment (SYSnnn) 
for each 2260 Display Station or 1053 Printer included in the 
line group is specified in the TERM macro instruction for the 
terminal. (See the description of the TERM macro instruc¬ 
tion. ) Because data transfer can occur between the computer 
and only one 226 0 (or the 1053) at a time,, only one LCB is 
generated for the entire line group. 


SWITCH- 


YES 


NC 


H 


YES 


NO 




Specifies that the lines in this line group are switched 
lines; that is, the line connection between the system and the 
terminals is not permanent. 

Specifies that this line group consists of nonswitched lines; 
that is* the line connection is permanent. 


AOTCPCL = YES 
AUTCPCL = NC 


YES 


NO 


Specifies that the polling process, for the lines in this line 
group, is under the control of the Auto Poll feature. 

Specifies that the Auto Poll feature is not available for this 
line group. 

If this operand is emitted, AUTOPOL=NO is assumed. 


Figure 8. Keyword Operands for the nonaudio Communication Line Group DTFQT Macro 
Instruction (Part 1 of 8) 
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j Keyword Operand 

i-- 

I CU=cc<3e 


j Value Eescription 

+ - 

| cede 

j Defines the type of telecommunications control unit as a 2701 w 

j 2702, 2703* or 2848. CU=2701 must be specified if DEVICE=2848 

j is specified. CU=2848 must be specified if DEVICE=2260 is 

| specified. CU=2702 or 2703 must be specified if AUTOPOL=YES 

j is specified. 


DEVICE-code 


code 

Specifies the type of terminal associated with the line group 
as a 1030, 1050, 1060, 2260, 2848, 83B3, 115A„ TW33, TW35,„ 
KTTA, 274A, 274B, 274C, 274D, 274E, 274F, 274G, or 274H. (See 
Note 2). 

Note I s DEVICE=2260 applies to the 2260 Local. 

DEVICE=2848 applies to the 2260 Remote 

Note 2 : IEM 2740 Communication Terminals are identified to 
the system using the following: 

Cn a nonswitched network: 

274A: Basic 2740 

274C: Basic 2740 with station control 

274D: Basic 2740 with station control and checking. 

274F: Basic 2740 with checking 

On a switched network: 

274B: Basic 2740 

274E: Basic 2740 with transmit control and checking 

274G: Basic 2740 with checking 

274H: Basic 2740 with transmit control 

Note 3 : If the terminal is an IBM Model 2 with record check¬ 
ing, 274D is specified; if the 2740 Model 2 is without the 
checking feature, 274C is specified. 


CPOLL= 

(pollname*,...) 


pollname A 

Is the name of the polling list for the first line in the line 
group. There must be one value (a polling list name) in the 
sublist for each line in the line group. The order of these 
polling list names must correspond to the order of the lines 
as specified in the LINELST keyword operand. Each polling 
list name must be identical to the name specified in the POLL 
macro instruction used to define the list for that line. If a 
line is used for output only, the name of a polling list with 
no terminal entries must be specified; any number of output- 
only lines may refer to this name. 

Example : CPOLL=(PCIL1,0UTPUT2,POLL3,0UTPUT2)- The fourlines 

to which the values in the sublist refer must be in the same 
order in the LINELST keyword operand as in the sublist above. 
OUTPUT2 is the address of a polling list with no terminal 
entries. The second and fourth lines, used for output only, 
refer to this address. 

If the line group is for a 2260-2848 Local, the sublist must 
contain only one entry: the name of the POLL macro defining 
all 2260 Display Stations in the line group from which mes¬ 
sages can be received. 


Figure 8. Keyword Operands for the nonaudio Communication Line group DTFQT Macro 
Instruction (Part 2 of 8) 
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| Keyword Operand | Value Eescription | 


| absexp | 
j Is the number of buffers to be requested for each transmission! 
I of data frcir a terminal to the computer. The requests are | 
j made in advance of the message transmission, and all buffers | 
f after the first are assigned as they are needed, absexp | 
j should be equal to or greater than 2, and must not be greater j 
j than either 255 or the number of buffers specified in the j 
j BUFFEB macro instruction, whichever is less. The primary fac-j 
j tors to be considered in determining the value of absexp are | 
j the line speed, the size of the buffer pool as opposed to the j 
j average number of buffers that are active at any one time, thej 
j size cf each buffer as opposed to the average size of a trans-| 
j mitted block, and total system loading. If this operand is | 
j omitted or if an illegal value is specified,, 2 is assumed. j 
j The following method of calculating BUFNO for each line group j 
j may be used. Assume the slowest-speed lines in the system to | 
| have a value of one. Then, assign to each of the remaining j 
j lines in the system a value whose ratio to one is the same as j 
j the ratio cf the line*s speed to the slowest line"s speeds j 
| The value cf the EUFNO operand for each line qroup equals the | 
j value for the lines comprising the group, plus one. | 

I I 

I Example: | 
j Line Group A has the slowest lines, 60 characters per j 
( second (cps)„ Its value is therefore 1. BUFNO =1+1=2. j 
j Line Group B has 120-cps lines; therefore its value is 120/| 
j 60, or 2. BUFNO for this line group is therefore 2+1=3. | 
j Line Group C has 150-^cps lines. 150/60, rounded up, is 3. j 
j For this line group, EUFNO =3+1=4. j 
j Line Group D has 180-cps lines*. 180/60 = 3. This line j 
j group, too, should have BUFNO equal to 3 + 1 = 4. | 

I I 

| For a 2260-2848 Local line group, absexp must define the | 
j number of buffers needed to contain the maximum length messagej 
j to be received from any 2260 Display Station in the line j 
j group. Due to the high data rate of this local device, all j 
j required buffers must be assigned before data transfer begins.j 
j If toe few buffers are specified, any excess data is ignored, j 
j and the •insufficient buffers* bit (bit 4) is set in the errorj 
j halfword for the line (see figure 13), | 

I ” \ 

| INPUT j 
j Indicates that the line group is to be used for input j 
j operations. | 
j CMBND j 
j Indicates the line group is to be used for both input and out-j 
j put operations. j 
j OUTPUT j 
| Indicates that the line group is to be used for output opera- j 
j tions. If OUTPUT is specified, the CPOLL keyword operand of | 
j the DTFQT macro instruction refers to a polling list with no j 
j terminal entries. OUTPUT must not be specified if SWITCH=YES | 
| or AUTCPOL=YES is specified. j 


(INPUT ) 
TYPEFLE=\CMENE > 

(output) 


BUFNC=absexp 

BUFBC=2 


Figure 8. Keyword Operands for the Communication Line Group DTFQT Macro Instruction 
(Part 3 of 8) 
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| Keyword 

H - 

| INTVL=a 

I intvl=o 


Operand 


j Value Description 


bsexp 


absexp 

Is the polling interval (that is, the number of seconds of 
intentional delay between passes through a polling list) for 
the lines in this line group. After all the terminals in a 
polling list for a given line have been polled (beginning to 
end), and if no message traffic was received from any terminal 
in the list, a delay equal to the number of seconds specified 
in this operand occurs before polling is restarted at the 
beginning of the list. However, if a message is received from 
any terminal represented in the list, the specified interval is 
ignored and polling resumes immediately at the beginning of the 
list. The puipcse cf the polling interval is to limit nonpro¬ 
ductive polling during slow traffic periods, absexp must not 
be greater than 255, If this operand is omitted, INTVL=0 is 
assumed; it must be omitted if this line group consists of 
switched lines, of lines using Auto Poll, of WTTA lines*, or is 
for the IBP. 2260-2848 Local. 

Restriction ; If this operand is specified,, the interval timer 
feature is required, and must be assigned to the foreground-one 
partition. With multitasking the main task cannot use STIXIT 
IT if C1AM is attached with operator control,, checkpoint by 
timer interval cr polling interval facilities. 


THFESH= 

absexp 2 

absexp) 

THRESH= 


(absexp^, 

, absexp 3 . 


(255,10, 5,5) 


Frovides the threshold values to be used in determining excessive 
number of errors (both temporary and permanent) for a specified 
number of transmissions for each line of this line group. This 
operand is not applicable and must be omitted for a 2260-2848 
Local line grcup. 

absexp^ 

The threshold value for the number of transmissions (must be 
from 1 to 255 inclusive). If the number of transmissions on 
any line in this line group reaches this threshold before any 
of the errcr counters reach their thresholds, the threshold 
counters are reset. 

absexp 2 

The threshold value for the number of data checks (must be from 
1 to 255 inclusive). If the number of data checks on any line 
in this line grcup reaches this threshold before the number of 
transmissions reaches its threshold value, a message is pro¬ 
vided (to the 1052 system console or the telecommunication sys¬ 
tem control terminal if the OPCTL macro instruction is 
included),, and the threshold counters are reset. 

absexp 3 

The threshold value for the number of Intervention required 
errors (must be from 1 to 255 inclusive). Same action is taken 
as in absexp 2 . 


Figure 8. Keyword Operands for the Nonaudic Communication Line Group DTFQT Macro 
Instruction (Part 4 of 8) 
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| Keyword Operand 


j Value Description 
.4- 


absexp | 

The threshold value for the number of timeouts, (except text | 
timeouts) must be from 1 to 255 inclusive* Same action is f 

taken as in absexp a . If this operand is omitted for a line j 

group other than the 2260*2848 Local the threshold values of j 
255, 10, 5, 5 are assumed. j 

F,E, or S j 

Indicates the relative priority to be given to sending and j 
receiving operations on the lines in the line group: j 

F — receiving has priority over sending. For polling lines, j 
output messages are sent when a polling interval is beingj 
observed. It should be noted that the specified polling j 
interval is observed only when no message traffic was j 
received during the polling pass just completed for the | 
line. j 

E — receiving and sending have equal priority. After each j 

full polling sequence on a given line, all output mes- j 

sages queued for that line are transmitted. j 

S — sending has priority over receiving. For polled lines, | 

output messages are sent on such a line after polling of j 
a terminal has resulted in a negative response or after j 
an incoming message ending with an EOT has been received* j 
For auto-polled lines, output messages are sent on such a| 
line after an incoming message ending with an EOT has j 

been received or after the end of the polling list has j 

been reached. In any case, polling on a line resumes j 

when the queue of output messages for this line is j 

, exhausted. j 

j If the line group consists of 2740 Model 2 (buffered) ter- j 

j minals, the relative priority of the lines remains the same, j 

j however, if queueing by terminal has been specified, messages j 

j are sent to alternating terminals on the line, within the j 

j priority with the following exceptions: | 

j E — a polling sequence will be executed when no message can j 

| be transmitted on the line because 88 buffer busy 8 * condi-j 

j tion has been signalled from all terminals with messages j 

| on the queue. Sending is resumed after each full polling! 

j sequence. j 

j S — output messages are transmitted until all queues are j 

j exhausted unless a 8 * BID 8 8 condition is detected. In j 

j this case message transmission is deferred until the j 

j remainder of the messages for the line have been trans- j 

j mitted and one polling sequence executed* j 

j For VJTTA lines, the relative priority is as follows: j 

j F or F — output messages are sent where there is no traffic j 

j ever the line after an EOT character has been received or| 

| after a time-out has occurred. j 

j S — output messages are sent when there is no traffic over j 

j the line, after an EOT or EOM character has been j 

S received, or after a time-out has occurred j 

| If the line group consists of i) IBM 2740 terminals, types j 

j 274A cr 274F, ii) switched lines, or iii) IBM 2260-2848 Local j 

j terminals, this operand must be omitted. | 

j If this operand is emitted, CPRI=S is assumed* \ 


Figure 8. Keyword Operands for the Nonaudio Communication Line Group DTFQT Macro 
Instruction (Part 5 of 8) 
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| Keyword Operand 

K-- 

I RTYFE=SHORT 
I RTYFE=NCRM 


j Value Eescription 

I This operand applies only to an IBM 2260-2848 Local line 

j group. It specifies the type of Read operation to be per- 

| forired when receiving from the 2260 Display Stations included 
j in the line group. 


SHORT 

Specifies Short Read DS MI. 

NORM 

Specifies Read DS MI. If this 

operand is emitted and CU=284 8 is coded,,, TYPE-NORM is assumed. 


ACLCC=integer 

ACLCC=subfield 


integer 

Is the position, relative to zero, of the device-access field 
for each terminal table entry defined by a TERM macro and 
associated with this line group. All terminal table entries 
begin on a fullword boundary. The value of integer is the sum 
of 2 

9 + c + c + r 

where 9 is the number of bytes placed by QTAM at the beginning 
of each terminal table entry; c is the maximum number of char¬ 
acters used in the name field of any TERM, LIST, or PROCESS 
macro within the terminal table IJLQTTID field; o is the total 
number of bytes (including any bytes necessary for boundary 
alignment) within the optional-area subfields of each terminal 
table entry associated with the line group (see the OPTION 
macro instruction description); and r=2 if the OBR/SDR (Out¬ 
board Reccrder/Statistical Data Recorder) option is included 
in the message control program, otherwise r=0. 

CT£M uses the value specified in this operand to obtain 
from the device-access area: 

1. the polling and addressing characters for terminals on 
ncnswitched lines, 

2. dialing infmation for terminals on switched lines, or 

3. the CCE for terminals in a 2260-2848 Local line group, or 

4. the terminal identification field for WTTA terminals. 

Example : If the maximum number of characters in the name 

field of TERM macros for this line group is eight, the number 
of bytes used for cptional-area subfields is 13, and the 0BR/ 
SDR option is not included, "integer" =9+8+13+0= 30. 
Therefore, ACLCC = 30. 

subfield 

Is the name of the last optional subfield used in this line 
group. If SEPASM=YES is specified, this method of specifying 
ACLCC cannot be used. If no optional subfield is used in this 
line group and if SEPASM=NO is specified or assumed, the ACLOC 
operand may be omitted. 


Figure 8. Keyword Operands for the Nonaudio Communication Line Group DTFQT Macro 
Instruction (Part 6 of 8) 
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j Keyword Operand 

hr -r- 

| [SEPASM=YES| 

I SEPASK=NO 


j Value Description 


Specifies that this DTFQT is to be assembled separately from j 
the rest of the user's code* I 


Specifies that this DTFQT is to be assembled with the rest of 
the user*s code. 


~mcn=yes 

MCN=NC 


(WTTA lines cnly) 


Specifies that each terminal of the line group is equipped 
with the optional Nctor-On feature. 


Specifies that the terminals are not equipped with the Motor- 
On feature. NO is assumed if this operand is omitted. 


MCNELY=integer 

MCNELY=15 


(WTTA lines cnly) 


integer 

Specifies the number of Mark characters corresponding to a 
1.5-second time-out when the terminal is not equipped with 
the optional Motor-On feature. MONDLY=10 corresponds to 50- 
service MCNDLY=15 corresponds to 75-baud service,, and MONDLY= 
20 corresponds to 100-baud service. When this operand is 
omitted or integer exceeds 20„ M0NDLY=15 is assumed. 


~IAM=YES~ 

iam=nc 


(WTTA lines cnly) 


Specifies that the terminal can ask for the computer identifi¬ 
cation sequence by sending FIGS D. 

Specifies that the computer cannot ask for the identification 
sequence of the terminal. NO is assumed if this operand is 
omitted. 


WRU=YFS 

WRD=NC 


(WTTA lines cnly) 


Specifies that by sending FIGS D„ either the computer or the 
terminal can ask for the identification sequence of the other. 
When WRU=YES is specified,„ IAM=YES is assumed. 

Specifies that the computer cannot ask for the identification 
sequence of the terminal. NO is assumed if this operand is 
omitted (see Ncte 2). 


ECM=WBU 
ECM=X•hh * 
ECM=X'hhlF' 


(WTTA lines only) 


Specifies that the end-of-message signal is either the WRU 
signal (when WRU=YES or IAM=YES is specified) or FIGS D (when- 
both WRU=NC and IAM=NO are specified). FIGS x is set as FIGS 
D in the adapter (see Note 1). 

X'hh* 

Specifies that FIGS x is used as the EOM signal, hh is the 
hexadecimal representation of FIGS x set in the adapter. 

X'hhlF* 

Specifies that FIGS y LTRS is used as the EOM signal. hh is 
the hexadecimal representation of FIGS y set in the adapter. 
WRE is assumed if this operand is omitted. 


Figure 8. Keyword Operands for the Nonaudic Communication Line Group DTFQT Macro 
Instruction (Part 7 of 8) — Applicable only to WTTA Lines 
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| Keyword Operand 

K--~ 

I BCT=2EO« 

I ECT=X*hhlF* 



j Value Eescription 
| 2ECW 

j Specifies that two consecutive EOM signals will be recognized- 
j by QTSM as end-cf-transmission, except when IAM=YES and 

j ECM=WI<U are specified.. 

I 

j X *hhlF• 

j Specifies that FIGS y LTRS is used as the EOT signal (see Note 
j 1). iherefcre* ECN=X , hhlF l can not be specified for the EOM 

j signal. 

I Note: A timo-cut is also recognized as EOT. Moreover* two 
j consecutive EOM signals are always recognized as an EOT sign- 

| al* except when IAN=YES and ECM=WRU are specified„ 


I Note 1 : In the preceding description of the EOM and EOT operands* x and y are the 
(values assigned by the user and set in the adapter at the time of installation of the 
| equipment. 

I 

| Note 2 : If neither IAM nor ViRt is specified* no exchange of identification sequences 
jean be requested. 


Figure 8. Keyword Operands for the Communication Line Group DTFQT Macro instruction 
(Fart 8 of 8— applicable only tc ETTA lines ) 

Examples : 

1. A ETFQT iracrc instruction that defines the DTF table representing a 
EASD message queues file: 


| Name j Operation j Operand 

V -+-+- 

j DISK j DTFQT | TYPE=DA,EEVADEE=SYS005*ECJAD=FINISH 


2. A ETFQT iracrc instruction that defines the DTF table representing a 
communication line group file: 


| Name | Operation ( Operand Col. 72 

I*-+-i-- 

j GRCUF1 | DTFQT j TYPE=LG*CLPS=IPS1*LINEIST=(006*007*008)„SWITCH=NO, 

j j | CU=2702*EEVICE=1050*CPCLL=(POLL1* POLL2* PCLL3)*BUFNC=3* 

| j j TYPEFLE=CMBND*ACLCC=16 


1 

I 

I 

I 

J 


CONTROL INFORMATI ON 


In constructing the message control pro¬ 
gram for his telecommunications system* the 
user must provide certain control informa¬ 
tion. This data includes: 

• A terminal table that contains all cf 
the terminal cedes as well as complete 
information about the terminals con¬ 
nected tc the system. These terminals 
include the message processing pro¬ 
grams* which are the only terminals to 
be specified fer an audio application. 

• A polling list, for each communication 
line* that specifies the sequence in 


which terminals on the line are to be 
polled. 


• Buffer specifications that define the 
maximum number of buffers for the QTAM 
buffer pool and the size of the message 
segments used in the system 


The IBM-provided logic that supports the 
message control program uses this control 
information in performing the message 
handling functions specified by the user. 
Macro instructions are provided that allow 
the user to define the terminal table* pol¬ 
ling lists* and buffer areas in accordance 
with the requirements of his application. 
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TERMINAL TABLE 


A telecommunications systeir using QTAM 
requires one teririnal table. 

For the polling system of the tele¬ 
communications system, control information 
macro instructions are used tc produce, at 
assembly time, a terminal table tailored to 
the user's device configurations and 
options desired. The terminal table con¬ 
sists of an 8-byte table control field 
defining the length cf the table, and 
blocks of information about each terminal. 
Each such blcck is called a terminal table 
entry. The four types of entries are: 
terminal, group cede, distribution list* 
and process program. Each entry in the 
terminal table begins on a fullword 
boundary. 

Each type of entry is described in 
Appendix A and in the following paragraphs. 

The size,, structure, and contents of the 
terminal table are based on information 
provided by the user through the TERMTBL, 
OPTION, TERM, LIST, and PROCESS macro 
instructions. 

• TERMTBL is specified once and defines 
the limits cf the table. 

• TERR creates a single terminal or group 
code entry in the terminal table. 

• OPTION names and allocates storage fer 
an optional subfield to be included in 
the user area cf a terminal table 
entry. The optional subfields can con¬ 
tain information needed tc perform 
various cpticnal functions provided by 
QTAM (subsequently discussed) or the 
user or both. The initial contents of 
each subfield are specified by the TERM 
macro instruction that defines the 
entry. 

• LIST defines a distribution list entry. 

• PROCESS creates a process program 
entry. 


Single Terminal Entry 


The terminal table must contain a single 
terminal entry for each terminal that can 
send and receive, send only, or receive 
only a message (except for a terminal in a 
group code entry discussed below). If a 
terminal component is individually polled 
or addressed, it must also have a separate 
single terminal entry. 


Each single terminal entry contains a 
minimum of seven fields. The names of the 
first six fields are provided in a DSECT 
generated by the expansion of the TERMTEL 
macro instruction. The first five fields 
in each entry are of standard length and 
are described below: 


Description 

Size of the entry. 

Address of the queue control 
block for the DASD destination 
queue associated with the 
terminal. 

Sequence number for messages 
incoming from this terminal. 

Sequence number for messages 
outgoing to this terminal. 

Status information indicating 
whether messages to the termi¬ 
nal are to be suppressed,, 
whether messages can be sent 
to the terminal, and whether 
messages can be received from 
the terminal. 

The sixth field (IJLQTTID )„ containing 
the name assigned to the terminal by the 
user, appears in each single terminal 
entry. This name is the same name that can 
appear in the source or destination code 
field of the message header. The length of 
this field is the same in each entry and is 
based on information provided by the user. 
If the rumber of characters in each termi¬ 
nal name varies, the number of bytes in 
this field is equivalent to the number of 
characters in the longest terminal name. 

The user must specify this number in the 
TERMTBL macro instruction. If the number 
of characters in each terminal name does 
not vary, the number of bytes in this field 
is equivalent to the fixed number of char¬ 
acters. The IJLQTTID field can be a maxi^ 
mum of eight bytes. 

Inclusion of the seventh field is 
optional. This field, called the user 
area , can contain one or more optional sub¬ 
fields. The name*, length*, and boundary 
alignment of each such subfield, if any, 
are specified by an OPTION macro instruc¬ 
tion; the data content of the subfield is 
specified by a TERM macro. Optional macro 
instructions such as COUNTER, DIRECT, 
ERRMSG, INTERCPT, POLLIMIT, and REROUTE 
introduce routines that either obtain 
information from or place information into 
these subfields in order to perform their 
functions. The user can also store infor¬ 
mation into this area. Each single termi¬ 
nal and group code entry associated with 


Field 
IJLQTSZE 
IJLQTQAD 

IJLQTSIN 
IJLQTSOT 
IJLQTSTA 
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the saire line group must contain the same 
optional subfields. 


The eighth field, called the device 
access area, is required. If the terminal 
is cn a ncnswitched line, this area con¬ 
tains the polling and/or addressing charac¬ 
ters fcr the terminal. If the device is a 
Villa terminal, this area contains the ter¬ 
minal identification sequence. For a ter¬ 
minal on a switched line, this area is com¬ 
posed cf the number cf digits in the tele¬ 
phone number, the telephone number, and a 
third field as fcllcws: 

1. For an IEM 1050, the addressing char¬ 
acters for the terminal. 

2. For a TWX terminal, the characters in 
the TWX terminal identification 
sequence. 

3. For an IBiy. 2260 or 1053 in a 2260-2848 
local line grcup, a CCE and other con¬ 
trol information required for the 
device. 

The size cf the device access area depends 
on the requirements fcr the particular 
device* This field immediately follows the 
IJLQTTID field if no optional subfields are 
included in the user area. If cpticnal 
subfields are included, the device access 
field follows the last subfield. The total 
size cf the terminal name area, opticnal 
user area, and device access area must net 
exceed 243 bytes. 

The TERM macrc instruction provides the 
initial contents for all fields in the 
single terminal entry. Detailed informa¬ 
tion on this entry is contained in appendix 
A. 


Group Code Entry 


A group code entry is identical in stru¬ 
cture to the single terminal entry. Howev¬ 
er, three fields either are not used or are 
used in a different manner. QTAM incre¬ 
ments by one the sequence number for outgo¬ 
ing messages (IJLQTSOT field) when the 
group is simultaneously sent a message. If 
any terminal in the group is also repre¬ 
sented by a single terminal entry,, the out¬ 
put sequence number for that entry is not 
changed. 

The sequence number for incoming mes¬ 
sages (IJLQTSIN field in the single termi¬ 
nal entry) is not applicable to the group 
code entry because the terminal group can¬ 
not collectively send a message to the sys¬ 
tem. For the same reason.,, there are no 
polling characters in the device access 
area of the group code entry. The total 
size of the terminal name area, optional 
user area w and device access area cannot 
exceed 243 bytes. 

The TERM macro instruction provides the 
initial contents for all fields in the 
group code entry* Detailed information on 
this entry can be found in Appendix A. 


Distribution ^List Entry 


A distribution list entry contains a 
list of addresses of single terminal 
entries. These addresses are grouped under 
the list name. When the list name is used 
as a destination code for a message,, QTAM 
sends the message via separate transmis¬ 
sions to all terminals indicated by the 
list. Each terminal in the list must have 
a corresponding single terminal entry in 
the terminal table. 

Each distribution list entry contains 
five active fields and the list area. The 
first four active fields in each entry are 
of standard length. A description of the 
five active fields follows: 


The group code entry is applicable only 
to AT ST 83B3, WU Flan 115A, IEM 2740’s with 
station ccntrcl (with or without checking), 
and IEM nonswitched 1050 terminals. 

The terminal name in a group code entry 
represents a prespecified group of ter¬ 
minals cn a line with special equipment 
that provides the grcup code feature. The 
feature permits simultaneous transmission 
of a message to a grcup of terminals 
through the specification of a single set 
of unique addressing characters. Several 
combinations cf prespecified terminals can 
be grouped for this purpose. Each grcup 
has a grcup terminal name and a correspond¬ 
ing group code entry in the terminal table. 


Field 

XJLQTSZE 

IJLQTQAD 


IJLQTLRA 

IJLQTSTA 


Description 

Size of the entry. 

Address of the queue control 
block for the distribution 
list queue. 

An access key to the start of 
the list of addresses. 

Status information. This 
field functions in the same 
way as the corresponding field 
for a single terminal entry 
with the following excep¬ 
tion: the receive bit in this 
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field is never used because 
terminals in the list cannot 
collectively send a message to 
the system* 


IJLQTTIE Contains the distribution list 
name. This name serves the 
same purpose as the terminal 
name in a single terminal 
entry and is subject to the 
same restrictions. 

The list of addresses of single terminal 
entries follows the fifth active field. 

This list contains, in each of its sub¬ 
fields (reladdr A through reladdr n ), a rela¬ 
tive address that locates the corresponding 
single terminal entry in the terminal 
table. These addresses are relative to the 
base address cf the table. The last sub¬ 
field in the list is zero, indicating the 
end of the distribution list entry. The 
total size of the distribution list name 
area and the list area cannot exceed 243 
bytes. 

The LIST macro instruction provides the 
initial contents for all fields in the dis¬ 
tribution list entry. Detailed information 
on this entry can be found in Appendix A. 


Process Program Ent ry 


The terminal table must include one pro¬ 
cess program entry for each DASE process 
queue (that is, one for each message pro¬ 
cessing program). The structure of this 
entry is the sane as that of the single 
terminal entry with the following 
exceptions: 

1. The IJLQTSIN field used in the single 
terminal entry is not used for the 
process prpgram entry. 

2. The receive bit in the IJLQTSTA field 
is not used for the process program 
entry. 

3. The IJLQTlID field in the process pro¬ 
gram entry contains the name of a DftSD 
process queue rather than a terminal 
name. 

4. There is nc optional area cr device 
access area in the process program 
entry. 

The PROCESS macro instruction provides 
the initial contents for all fields in the 
process program entry. Detailed informa¬ 
tion on this entry can be found in Appendix 

A. 


Terminal Table (TERMTBL) Macro Instruction 


The TERMTBL macro instruction causes a 
table control field to be created for the 
terminal table and defines the length of 
the table. Depending upon the type of app¬ 
lication, the expansion of this macro 
instruction also generates up to four 
DSECTs that enable the user's symbolic 
references to communicate with those of 
QTAM. One DSECT provides names for the 
fields in each terminal table entry. 

Another DSECT generated by TERMTBL supplies 
names for the fields in a line control 
block (LCB); QTAM maintains an LCB for each 
communication line. Each LCB contains con¬ 
trol information about its associated line. 
The fourth DSECT provides names for the 
buffer prefix. 

One TERMTBL macro instruction is 
required, and it must precede all other 
macro instructions used in creating the 
terminal table. 

r - T -T-1 

|Name|Operation|Operand | 

Y -+- 4 - i 

j TERMTBL |entry„[n] | 

III I 

j | j [ „OPCTL=chars ] | 

III I 

j J j UCPINTV= integer3 j 

111 I 

j } |[ w OBRSDR=integer] j 

l - X -JL-J 

entry 

Is the name of the last entry in the 
terminal table. 

n 

Is the number of characters in the 
longest terminal entry, distribution 
list entry, or process entry name. 

This operand is not necessary if the 
lengths of all terminal names are the 
same. 

OPCTL 

The name of the OPCTL macro instruc¬ 
tion in the LPS. This operand speci¬ 
fies that error messages are to be 
sent to the operator control terminal 
specified in the OPCTL macro instruct 
tion,, rather than to the 1052 system 
console. When this operand is speci¬ 
fied^ error messages that originate 
from errors on the operator control 
terminal receiving error messages are 
printed on the 1052 system console. 
This operand must not be specified 
unless the OPCTL macro instruction is 
specified in the LPS. When this 
operand is not specified,, the error 
messages continue to be sent to the 
1052 system console. 
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CPINTV 

The number of 15-second intervals 
between checkpoints. It must be an 
integer from 1 (15 seconds) to 60 (15 
minutes) inclusive. Note that if this 
operand is specified, the interval 
timer feature is required, and must be 
assigned to the foreground-one parti¬ 
tion. In multitasking, the main task 
cannot use STIXIT IT if £T£M is 
attached with operator control, check¬ 
point by timer interval,, polling 
interval facilities, or 2740 Model 2 
in the application. 

OBRSDR 

The number cf 8-byte SCR (Statistical 
Eata Recorder) counter sets to be pro¬ 
vided. It is calculated by counting 
one for each terminal and cne for each 
dial line; if not enough counter sets 
are specified, the error ccunts for 
seme terminals will be lost. Note 
that if this operand is specified, 
both CBR (Outboard Recorder) and SDR 
facilities fer recording error infor¬ 
mation are included in the message 
control pregram. 

Note: The name field is ignored. 

IJLCTTEL is the name generated for the 
terminal table by the macrc instruc¬ 
tion expansion. 


Terminal Table Optional Field (OPTION) 
Macro Instruction 


The OPTION macrc instruction names and 
allocates, at assembly time, a specified 
amount cf main storage in selected single 
terminal and group code entries in the ter¬ 
minal table. The storage allocated consti¬ 
tutes the optional area field of the 
entries. One OPTION macro instruction is 
required for each optional area subfield 
desired. The order cf the subfields within 
the optional area is determined by the 
order cf the OPTION macro instructions. 

Eata values inserted into each optional 
area subfield are specified by the opdata 
operand of the TERM macro instruction that 
creates the entry. If a TERM macro 
instruction does net specify data values 
for the optional area, the optional area 
field is not included (that is, main 
storage is net allocated) in that entry. 
However, if the optional area is specified 
for any terminal in the line group, the 
space is reserved for every terminal in the 
line group (see the TERM Macro Instruction 
description). 

The OPTION macro instruction (s), if 
used, must immediately follow the TERMTEI 


macro instruction. The relative order of 
the specified subfields must correspond to 
the order in which the contents for the 
subfields are specified in the TERM macro 
instructions. 

Six LPS macro instructions link to IBM- 
provided routines that use fields allocated 
by OPTION macros in performing their func¬ 
tions. These optional LPS macros are COUN¬ 
TER, DIRECT, ERRMSG, INTERCPT,, POLLIMIT, 
and REROUTE; the functions provided by 
these macro instructions are discussed 
under the individual macro instruction 
descriptions. User-written routines can 
also store information into a subfield 
defined by an OPTION macro. 

|Name |Operation[Operand | 

]subfield)OPTION jtypelength | 

subfield 

Is the name of the optional-area 
subfield. 

typelength 

Is the type and length of the subfield 
in the standard assembler language 
format (for example, H„ CL8, AL3). 

When the subfield is used in conjunc¬ 
tion with the DIRECT,,, ERRMSG,, or 
REROUTE macro instruction, CLn must be 
specified where n equals or exceeds 
the longest name of any terminal table 
entry. If used in conjunction with 
the COUNTER macro instruction, "type- 
length" should be specified as H since 
COUNTER requires a half-word field 
aligned on a half-word boundary to 
perform its function. INTERCPT and 
POLLIMIT require 3-byte and 1-byte 
fields*, respectively; no boundary ali¬ 
gnment If used in conjunction with 
the POLLIMIT macro instruction,, "type- 
length" must not be specified as C (or 
CL1)„ because the field must contain a 
binary value rather than a character 
representation. 

Example : The following is an example of 
the use of the TERMTBL and OPTION macro 
instructions: 

r-r- t- 1 

|Name |Operation)Operand | 

J--+-+-1 

] |TERMTBL |KCHI j 

]POLLMT jOPTION |FL1 ] 

|COUNT 1 OPTION |H | 

j ALTNTERM j OPTION j CL4 | 

jINTECPT (OPTION j XL3 j 

l_J_J.___J 

TERMTBL defines KCHI as the terminal 
name in the last entry in the terminal 
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table. The GFTICK iracro instructions 
allocate a 10-byte optional etxea for 
single-terminal and group-code entries in 
the terminal table. The optional area con¬ 
sists of four sukfields: the PCLLMT sub¬ 
field contains one byte of data to be used 
by the PCLLIMIT macro? the COUNT subfield 
contains a half-word for decimal data to be 
used by the COUNTER macro; the ALTNTERM 
subfield contains four bytes for a charac¬ 
ter string to be used by the CIRECT macro; 
and the INTECPT subfield contains three 
bytes for hexadecimal data to be used by 
the INTERCPT macro. 


The halfword specification fcr the COUNT 
subfield causes the assembler tc perform 
boundary alignment; however, in this case, 
no adjustment is necessary because the 
COUNT subfield already begins on a half¬ 
word boundary. If, in some other case, 
bytes are skipped by the assembler in per¬ 
forming boundary alignment, the number of 
bytes skipped must be included in the cal¬ 
culation of the ACLCC keyword operand in 
DTFQT macro for tbe line group affected. 


Terminal Table Entry (TERM) Macro 
Instruction 


The TERM macro instruction causes a ter¬ 
minal name and associated terminal informa¬ 
tion tc be included as an entry in the ter¬ 
minal table. If a single terminal or com¬ 
ponent is involved, TERM produces a single 
terminal entry. If a group of terminals 
having the group code feature is involved, 
TERM produces a grcup code entry. One TERM 
macro instruction is required fcr: 

1. Each terminal (tctb switched and non- 
switched) that can send r receive, or 
send and receive messages. 

2. Each group of ncnswitched terminals 
equipped with the group code feature. 
Terminals can only receive messages 
under the grcup code feature. Each 
terminal in the group that can also 
send messages must be represented by a 
single terminal entry. 

All TERM macros in the same line group 
must be grouped together. If messages are 
to be queued by line rather than by termi¬ 
nal, the individual TERM macros must be 
grouped by relative line number within this 
TERM coding section. TERM entries within a 
line grcup must have exactly the same for¬ 
mat. The same option fields and the same 
number of dial digits and addressing and 
polling characters must be specified. 


r-- t-t---1 

| Name |Operation|Operand | 


j symbol|TERM 

jqtype,filename,rln 


i i 

j[,adchars] 


i i 

j(,(opdata,...)] 


i i 

j[,CALL=integer1 


i i 

|L,CALL=NONE J 


1 i 

]t,ID=hexchars] 


1 1 

|[,DEVADDR=SYSnnn3 


1 ! 

j [„PRNTR=YES] 





symbol 

Is the terminal name containing one to 
eight nonblank characters; it must be 
specified. This name is the same name 
that appears in the source or destina¬ 
tion code field of a message header. 

qtype 

Specifies the type of message 
queueing. 

T specifies that outgoing messages are 
to be queued by terminal; that is, all 
messages for a given terminal are sent 
before any messages for other ter¬ 
minals are sent. (This is economical¬ 
ly advantageous when the destination 
terminal is on a switched line.) 
Highest priority messages for the 
given terminal are sent first. T must 
be specified for switched terminals,, 
and may be specified for nonswitched 
terminals. 

L specifies that outgoing messages are 
to be queued by communication line; 
messages for all terminals on the line 
are sent on a first-in-first-out basis 
within priority groups. If L is spe¬ 
cified, all TERM macros for each line 
must be grouped together. L may be 
specified for nonswitched terminals? 
it cannot be specified for switched 
terminals. It is recommended that L 
be specified for terminals in a 2260- 
2848 Local line group. 

Note 1 : Since only one terminal can 
be connected to a WTTA line, T and L 
are equivalent. 

Note 2 : If the terminal is a 2740 
Model 2, T should be specified. 

filename 

Is the name of the DTF table for the 
communication line group in which the 
terminal is included. 

rln 

Is the relative line number, within 
the line group, of the line over which 
the computer and the terminal commun¬ 
icate. Within a line group, the rela¬ 
tive line numbers specified must be 
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consecutive integers beginning with 
cne (zero is invalid),. For a switched 
terminal, any value up tc the highest 
numbered access line ip the line group 
may be specified. When the computer 
calls a terminal, it attempts to make 
the call using the specified line 
number. If that line is busy, the 
call is retried using the next higher 
numbered line, and so cn until a free 
line is found. If all remaining lines 
in the grcup are busy, the message is 
not sent until a line becomes avail¬ 
able. A relative line number of one 
must be specified for terminals in a 
2260-2848 local line group, because 
only one ICE is generated for the 
entire line grcup. 


adchars 

Pxe the addressing and/or polling 
characters fcr the terminal. The TERM 
macro expansion places these charac¬ 
ters in the device access area of the 
terminal table entry. Refer to Figure 
9 for the number and kind cf charac¬ 
ters to be specified for each type cf 
terminal and line. The characters are 
specified by writing the hexadecimal 
equivalent cf the appropriate device 
code representation. This operand 
must be emitted for a TWX terminal, 
for WTTA terminals, fcr IBM 2740 ter¬ 
minals, Types 274A„ 274B, 274E, 274F* 
274G, and 274B, and for IBM 2260 or 
1053 terminals in a 2260-2848 Local 
line group. Its omission must be 
indicated by a comma if the positional 
cpdata operand is used. If the opdata 
operand is not used, no comma is coded 
tc denote emission of the adchars 
operand. Kc polling characters are 
specified for a switched IEM 1050 ter¬ 
minal. If polling is required for a 
switched IEM 1050 terminal, the pol¬ 
ling characters are specified in a 
FOIL macro instruction. 

Examples : (1) If the addressing and 

polling characters for a ncnswitched 
IBM 1050 are R9 and R0, adchars is 
written D213E215 (E211 and D215 are 
the hexadecimal equivalents of the 
device code representation of R9 and 
B0). (2) If the polling characters of 

a ncnswitched IEM 1050 that is only tc 
be polled (net addressed) are K0, 
adchars is written as xxxxC515, where 
xxxx represents the hexadecimal equi¬ 
valent of any two fill characters. 

(3) If the addressing and polling 
characters cf a nonswitched IBM 1030 
that is tc be pclled and addressed are 
F and I, adchars is written as 45xx46„ 
where xx represents the hexadecimal 
equivalent cf any fill character. (4) 
If the same IEM 1030 is to be 


addressed only*, adchars would be writ¬ 
ten as 45 (no fill character needed). 

opdata 

Is the actual data to be inserted into 
the optional area subfield(s) of the 
terminal table entry for this termi¬ 
nal. This operand allows flexibility 
because data can be specified for dif¬ 
ferent subfields depending on the 
optional functions required for mes¬ 
sages sent to or received from the 
terminal. All entries, however v 
representing terminals included in the 
same line group must have data speci¬ 
fied for the same optional subfields. 
(Figure 10 shows an example of data 
specified for different subfields in 
entries not associated with the same 
line group.) The maximum length and 
type of data specified for each sub¬ 
field must correspond to the length 
and type specified by the OPTION macro 
instruction that allocates the addi¬ 
tional storage required for the sub¬ 
field. A comma is used to: 

1. Delimit the data for each sub¬ 
field (except the last). 

2. Indicate that no data is speci¬ 
fied for an intermediate 
subfield. 

Framing characters such as X*, C„ and 
quotes are not coded. 

CALL 

Is the telephone number of the termi¬ 
nal. This operand must be specified 
for switched terminals only. NONE 
must be specified if the line is a 
WTTA line or if the lines over which 
contact with the terminal is to be 
established does not have the auto¬ 
call feature. 


Is the terminal identification 
sequence for the TWX or WTTA terminal 
represented by the terminal table 
entry created by this TERM macro 
instruction. 

For TWX terminals, this operand is 
specified only when the computer is to 
call a terminal. It is specified by 
writing the hexadecimal equivalent of 
the 8-level TWX code. When the com¬ 
puter calls the terminal,,, the terminal 
automatically sends an identification 
sequence. QTAM compares the sequence 
with the sequence specified by this 
operand, as a check that the intended 
terminal has in fact been reached. An 
equal compare permits message trans¬ 
mission to proceed. An unequal com¬ 
pare is treated as a negative 
response? the message is not sent. 
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Fcr WTTA terminals* this operand is 
specified only v»hen the WRD=YES is 
present in the ETFQT macro instruction 
for the line grcup- It is specified 
by writing the hexadecimal equivalent 
of the 5-level code used by the 
terminal. 

When an identification exchange is 
performed (with ViRU=YES specified in 
the DTFQT macro instruction), QTAM 
compares the terminal identification 
sequence with the sequence specified 
by the ID operand. On an unequal com¬ 
pare, the transmission-errcr bit is 
set on in the error halfword for the 
line. Moreover, if the identification 
exchange has teen performed at the 
beginning of an output message, the 
message-not-sent bit: is set on in the 
error halfword for the line. 

DEVAEER 

Specifies the symbolic unit to be 


associated with this logical device. 

An actual unit and channel is assigned 
to the device at execution time by an 
ASSGN statement. This operand must be 
specified for IBM 2260 or 1053 ter¬ 
minals in a 2260-2848 Local line 
group; for all other terminals* this 
operand must riot be specified. It 
generates a CCB and other control 
information required for the device- 


PRNTR 

PRNTR=YES is specified if the terminal 
is an IBM 1053 Printer in a 2260-2848 
Local line group or if the terminal is 
an IBM 2740 Model 2. 


Warning : Note carefully the discussion 

pertaining to the omission or inclusion 
of commas to indicate omitted adchars and 
opdata operands. 
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j Terminal Type 

i—-- 


j line Ttype j Specify j 

+ -+- 1 

| | AAFF (if polling and addressing are required) | 


IBM 1050, 1060, 

2260-2846 Remote 
AT€T 83B3, m 115A 


Ncnswitched 


ffFF (if only polling is required)* 
AA (if only addressing is required) 


IBiy. 1030 
IE M 2740, Types 
274C and 274E 


Nonswitched 


AfF (if polling and addressing are required) 


ffF (if only polling is required) 

A (if only addressing is required) 


IBM 2740, Types 
274C and 274E 


Nonswitched 
Auto Foil 


AfFs (if polling and addressing are required) 
ffFs (if polling only is required) 


IBP 2740, Types 
274A and 274F 


Nonswitched 


No polling or addressing characters 
are to be specified 


IB* 1050 


Switched 


AA (if addressing is required) 2 


ViU TWX 33, 35 


Switched 


CR IF I ± I 2 . . .I n CR LF XOn 

(This is the TWX terminal identification 
sequence; it is specified only if the computer 
is tc call the terminal.) 3 


IEM 2740*, Types 
274B*, 274E, 
274G„ and 274H 
IBM 2260-2848 local 


Switched 


No polling or addressing characters 
are to be specified. 


legend: A = cne addressing character CR = carriage return 

P = cne polling character LF = line feed 

s = cne space character 

f = cne fill character XOn = transmitter on 

I ± I 2 . . . I n = a sequence of characters identifying the TWX terminal 

A The second "F" must he specified as hexadecimal FF if a general poll of all 2260s 
attached to a 2848 is desired. 

2 If polling is required* the polling characters are specified in a POLL macro 
instruction. 

3 If the terminal is to call the computer, the computer identification sequence must 
he specified in a POLL macro instruction. 


Figure 9. Addressing and Foiling Characters for the TERM Macro Instruction 


Terminal Table list (LIST) Macro 
Instruction 


The LIST macro instruction causes the 
name of a list cf terminals,, relative ter¬ 
minal table addresses of the entries for 
the terminals in the list, and associated 
information on the list to he included as 
an entry in the terminal table. The list 
of terminals is called a distribution list, 
and the entry produced is a distribution 
list entry. 


One LIST macro instruction must be pro¬ 
vided for each such distribution list to be 
created. Terminals can only receive mes¬ 
sages through the distribution list trans¬ 
mission method; they cannot send them. 


r - r - t- 

|Name |Operation]Operand 

|symbol|LIST j entry 

l_JL_J_ 


symbol 

Is the name of the list. 


This must be 
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specified, and iray be from one to 
eight nonblank characters. 

entry,.*. 

Includes the names of the terminals 
that are to he in the distribution 
list. 

Restriction : A name representing another 
distribution list must not be included as 
an operand of the LIST macro instruction. 
All terminal names in the list must be 
defined by either a TERM or a PROCESS 
(without EXPEDITE option) macro 
instruction. 


Terminal Table Process (PROCESS) Macro 
Instruction 


The PROCESS macro instruction causes the 
name and associated information of a EASE 
process queue tc be included as an entry in 
the terminal table. The entry produced is 
a process program entry. It differs from 
other terminal table entries in that it 
does net have an optional area or device 
access area*, and the IJLQTSIN field is net 
used. A message processing program, like a 
terminal, can be a destination for a mes¬ 
sage. However, unlike a terminal, the pro¬ 
cessing program is net associated with a 
communication line and does net need 
addressing and polling characters. 

Cne PROCESS macro instruction must be 
included for each MS process queue that is 
defined by a DTF£T macro instruction in a 
message processing program. 

The EXPEDITE operand permits the user to 
speed the processing of messages by the 
message processing program associated with 
the process program entry. This function 
is valuable for an application requiring 
immediate transmission of data to a message 
processing program. A combination of the 
EXPEDITE function and conversational mode 
(subsequently discussed) provides the most 
rapid response to an inquiry. 
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| Name |Operation^ Operand 


j symbol j PROCESS jj [EXPEDITE] 


symbol 

Is the name of the process program 
entry in the terminal table. The name 
must be specified, and must be the 
same as the PROCESS keyword operand 
specified in the MS-process queue 
DTFQT macro instruction in a message 
processing program. The name can con¬ 
tain from one to eight nonblank 
characters. 

EXPEDITE 

This optional operand specifies that 
messages are to be routed directly to 
the message processing program®s MS- 
process queue, bypassing the normal 
intermediate step of placing the mes¬ 
sages on a DASD-process queue. EXPE¬ 
DITE should not be specified if multi¬ 
segment messages are expected, because 
segments from different messages may 
be intermixed as they are delivered to 
the queues. This restriction does not 
apply for multisegment messages 
received from an IBM 2260 Local. 

Note : The RETRIEVE macro instruction 

cannot be used to retrieve messages 
from a process queue when the EXPEDITE 
operand is used. Also, the EOA,> EOB. 
EOBLC, CANCELM. ERRMSG, and REROUTE 
macro instructions cannot be used for 
any message whose destination is a 
processing program identified by a 
PROCESS macro instruction with the 
EXPEDITE operand. 


Example — Terminal-Table Definition 


Figure 10 shows a coding sequence used 
to create a terminal table. The terminals 
are IBM 1050's attached to the computer by 
nonswitched lines. There is only one mes¬ 
sage processing program. 






Nc. 

— T - 

1 

Name 

| Cperation 

± 

- T - 

1 

_L_ 

Operand 


1 

J 

1 

2 

-j. — 

1 

1 

1 

I 

CCUNT 

| TERMTEL 

| OPTICN 

-r 

i 

i 

i 

i 

CPU, 

FL2 


1 

3 

I 

1 

1 

LIMIT 

| OPTICN 

1 

1 

i 

FL1 



4 

i 

1 

1 

LEST 

| OPTICN 

i 

i 

i 

CL3 



5 

1 

1 

1 

NYC 

| TERM 

i 

i 

i 

L,GROUP1,1„E407E40D, 

(0„8„EOW) 


6 

I 

1 

i 

ECS 

1 TERM 

i 

i 

i 

L„GROUP1„1„E207E20D, 

(0„3„NYC) 


7 

1 

1 

1 

WAS 

| TERM 

1 

i 

i 

L„GROU?1„2„E407E40D, 

(0„1„NYC) 


8 

1 

1 

i 

PEI 

| TERM 

1 

i 

i 

L*GROUP2„1„E407E40D, 

(0„ „ NYC) 


9 

1 

1 

I 

PIT 

| TERM 

1 

i 

i 

L„GR0UP3„1«E407E40D, 

(0) 


10 

1 

1 

I 

RAL 

| TERM 

1 

i 

i 

L„GROUP4„1„E407E40D 



11 

1 

! 

1 

ECW 

| LIST 

1 

i 

i 

(BOS,WAS) 



12 

1 

1 

_j._ 

CPU 

| PROCESS 

-1 __- 

! 

I 



J 


Figure 10. Example cf Coding Sequence Used tc Create a Terminal Table 


Instruction 1 (TE P MTBI) : Identifies the 
last entry in the terminal table. emission 
of the second operand indicates that all 
terminal names are cf equal length. 

Instructions 2 through 4 (OPTION) s Define 
the names and sizes of three optional area 
subfields used for functions specified by 
the COUNTER*, PCILIMIT, and DIRECT macro 
instructions, respectively (refer to the 
Line Procedure Specifications section for a 
detailed discussion of the functions per¬ 
formed by these macro instructions). The 
single terminal entries in which these sub¬ 
fields are included and used depends on 
whether the optional functions are speci¬ 
fied in the LFS that handles the line group 
associated with the entry. 

Instructions 5 through 10 (TERM) ; Define 
the single terminal entries for the ter¬ 
minals in four line groups. The operands 
of each TERM macrc instruction provide 
information for the fields of the respec¬ 
tive entries. In this example, outgoing 
messages are queued by line. Therefore, 
the first operand is an L in each case. 

The second operand of each TERM speci¬ 
fies the name of the DTF table for the line 
group in which the terminal is included. 

In this case, there are four line groups 
(hence,, four DTE tables). 

The third operand cf each TERM is the 
relative line number of the line to which 
the terminal is attached. The user estab¬ 


lishes the relative line number of each 
line at system generation. The relative 
line number can be modified by an ASSGN 
statement. In the line group associated 
with the DTF table named GROUP1,, the New 
York and Boston terminals are attached to 
one line (relative line number 1)„ and the 
Washington terminal is attached to another 
line (relative line number 2). Since the 
messages are queued by line,, individual 
TERM macro instructions must be grouped by 
relative line number. For example,, it 
would be incorrect if the TERM macro 
instructions in this line group were in the 
order: NYC,, WAS,, BOS. 

The fourth operand of each TERM contains 
the addressing and polling characters for 
the terminal. These characters are speci¬ 
fied in the hexadecimal equivalent of the 
device code. In instruction 5„ E407 is the 
hexadecimal equivalent of B3 and E40B is 
the hexadecimal equivalent of B6 in IBM 
1050 code. B3 constitutes the addressing 
characters? for IBM 1050s„ the first 
addressing character identifies the termi¬ 
nal, and the second identifies the com¬ 
ponent (the number 3 indicates the com¬ 
ponent addressed is a card punch). B6 con¬ 
stitutes the polling characters (6 is the 
identification of a card reader). Transla¬ 
tion of the addressing polling character 
representations in instruction 6 is A3A6? 
translations of instructions 7 through 10 
are all B3B6. If all these terminals were 
on the same line,, and all were to be 
addressed or polled individually, a unique 
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set of addressing and polling characters 
would have to be assigned to each terminal. 


The fifth operand of each TEEM contains 
the data to be inserted in the subfields 
defined by the CFTICN macro instructions. 
Instructions 5 through 7 specify data for 
all three optional subfields, because the 
IPS that operates on messages fcr this line 
group (GRCUP1) includes the COUNTER, P0LLI- 
MIT, and DIRECT macro instructicns. COUNT¬ 
ER uses the COUNT subfield to keep a count 
of all messages received by the New York, 
Boston* and Washington terminals, respec¬ 
tively. The count is set initially to zero 
in all entries. FCLLIMIT uses the value in 
the LIMIT subfield to restrict the number 
of messages that can be sent by a terminal 
during one polling pass. The New York 
(NYC), Boston (ECS), and Washington (WAS) 
terminals can send a maximum of 8, 3, and 1 
messages, respectively, during each polling 
pass. The DIRECT macro instruction uses 
the name specified in the DEST subfield to 
determine where tc send the messages ori¬ 
ginated by each terminal. All messages 
sent by the New Ycrk terminal are directed 
to the Eoston and Washington terminals 
because the distribution list entry* BOW, 
is specified. Messages sent by the Eoston 
and Washington terminals are directed to 
the New York terminal. 

Instruction 8 specifies data for only 
the CCUNT and DEST sutfields; a POLLIMIT 
macro instruction requiring information 
from the LIMIT subfield is not included in 
the IPS that operates on messages fcr this 
line group (GRCUF2)• It should be noted 
that an additional comma is required to 
specify that no data is inserted in the 
LIMIT subfield. Instruction 9 specifies 
data only for the CCUNT subfield because 
neither the PCIIIMIT nor DIRECT macro 
instruction is in the LPS for the line 
group (GRCUP3)• In this case, no addition¬ 
al commas are required because no subfield 
following the CCUNT subfield is used. 
Storage is not allocated for the LIMIT and 
DEST subfields in the terminal table entry 
for the Pittsburgh (PIT) terminal. 
Instruction 10 does not specify data for 
any of the optional subfields since none of 
the optional functions are specified in the 
LPS fcr the line group (GR0UP4). No 
storage is allocated for the optional area 
field in the entry fcr the Raleigh (RAL) 
terminal. 


Instruction 11 (LIST) : Creates a distribu¬ 
tionlist entry in the terminal table. 

When ECW (the name of the list) is found as 
a destination code in a message header or 
in the DEST subfield of the terminal send¬ 
ing the message, the message is routed tc 
the Ecstcn and Washington terminals. 


Instruction 12 (PROCESS) : Creates a pro¬ 
cess program entry in the terminal table. 
When CPU is specified as the destination 
code for a message, the message is routed 
to the message processing program repre¬ 
sented by this process program entry. This 
input message is either directly routed to 
the message processing program represented 
by the CPU process program entry* or it is 
queued on the waiting chain located in the 
expansion of this macro instruction. 


POLLING LISTS 


Polling is a centrally^controlled method 
of permitting each terminal on a multiter¬ 
minal nonswitched line to send messages 
without contending for use of the line. 

QTAM contacts the terminals in the order 
established by a user-specified polling 
list. The polling list consists of control 
information followed by a series of poin¬ 
ters to those terminal table entries repre¬ 
senting terminals to be polled. In opera¬ 
tion* QTAM steps through the pointers one 
by one. For each pointer* QTAM finds the 
polling address in the indicated terminal 
table entry and sends that address on the 
line. As each terminal recognizes its 
unique address,, it either sends a message 
if one is ready for transmission* or it 
sends a negative response if no message is 
ready. 

After a message is received from a ter¬ 
minal* the same terminal is again polled 
and it again sends a message if one is 
ready. This process is repeated until the 
terminal has no more messages to send or 
until the user-established polling limit 
for that terminal is reached, whichever 
occurs first. (The POLLIMIT macro instruc¬ 
tion is used to set the limit.) 

Each time a negative response is 
received by the computer or the polling 
limit is reached* QTAM repeats the polling 
process using the next pointer in the list. 
This operation is repeated until the termi¬ 
nal represented by the last pointer in the 
polling list has sent a negative response 
or has sent its last message. When this 
occurs, the polling process is repeated* 
starting at the beginning of the list. If 
the user has specified a polling interval 
in the DTFQT macro instruction for the line 
group and if no message traffic was encoun¬ 
tered during the polling pass just com¬ 
pleted* the next pass through the polling 
list is deferred for the time specified; 
otherwise* polling proceeds continuously. 

A polling list must be specified for 
each nonswitched line in the system. In 
defining a list for a nonswitched line* 
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theuser iray enter teririnal naires as irany 
tiroes as he wishes, and in any crder. A 
list can include terminals cn one lire 
only. If a line is used for output only, 
the user roust specify a polling list with 
nc teririnal entries. 

If there are cnly a few terminals on a 
line, QTAM performance may be inproved by 
specifying the terminal names mere than 
once in the polling list. This improvement 
is due tc the CPU time involved in cleaning 
up after a negative response to polling and 
in preparing tc pell the line again, rela¬ 
tive tc the time spent in polling the line. 
There should be about ten entries in the 
polling list for optimum performance. 

Another advantage gained by specifying 
the terminal naires mere than once in the 
polling list is that some of these entries 
may subsequently be treated as dummy 
entries for the purpose of expanding the 
polling list. Refer to the discussion of 
the CENGP macro instruction for a discus¬ 
sion cf this procedure. 

The polling process has a different 
meaning fer switched lines. For non- 
switched lines, the computer always 
initiates contact with the terminals. 
However, for switched lines, the terminal 
normally initiates the contact. The pol¬ 
ling function, in this case, consists only 
of sending the polling address to the ter¬ 
minal that initiates the contact. The ter¬ 
minal responds by sending one or more mes¬ 
sages. The polling address is sent by the 
computer after each message is received. 

The polling list for a switched line does 
not contain pointers to terminal table 
entries. Rather, it contains a single pol¬ 
ling address (except for TWX terminals), in 
addition tc ccntrcl information. When a 
terminal dials the telephone number asso¬ 
ciated with the line represented by this 
polling list, QTAM sends the polling 
address cn the line. 

In the case cf the TWX t 2 rminals, the 
polling function consists of sending cn the 
line a character sequence rather than a 
polling address. Otherwise, the polling 
function is identical. 

For WTTA lines, the polling list con¬ 
tains cnly the CPU identification sequence 
to be sent to the terminal each time an ... 
identification exchange is to be performed. 

The polling list has a different meaning 
for a 2260-2848 Local line group. Cne, and 
only one, polling list must be specified 
for the line group. This polling list must 
contain the names cf all IEM 2260 Display 
Stations in the line group from which mes¬ 
sages are tc be received. A terminal iriust 
not appear in the list more than once. 


Messages are not accepted from 2260s not 
defined in the list. If the operator of an 
undefined terminal attempts to enter a mes¬ 
sage by pressing the ENTER key, the subse¬ 
quent Attention interrupt is ignored. 

QTAM uses the polling list at open time, 
when the CCB for each 2260 Local terminal 
in the list is queued on the DOS channel 
scheduler queue in anticipation of receive 
ing a read request (Attention interrupt) 
from the device. Thereafter, the CCB is 
always maintained on the channel scheduler 
queue except when QTAM is sending a message 
to the terminal. 

The POLL macro instruction is used to 
define polling lists for both switched and 
nonswitched lines. QTAM also provides rou¬ 
tines for examining and modifying polling 
lists- The macro instructions used for 
implementing these routines are described 
in the section. Examining and Modifying the 
Telecommunications System - The structure 
of polling lists is shown in Appendix A. 


Polling List Definition (POLL) Macro 
Instruction 


POLL generates a polling list for a spe¬ 
cific line attached to the telecommuni¬ 
cations control unit (TCU), or for all 2260 
Local terminal from which messages may be 
received in a line group. For a non¬ 
switched line, it defines the order in 
which terminals on the line are to be 
polled. For a switched line, it specifies 
the polling address or identification 
sequence to be sent to any terminal that 
calls the computer on the line represented 
by the list. For a WTTA line, this operand 
specifies the CPU identification sequence 
to be sent during an identification 
exchange. For a 2260-2848 Local line 
group,, it defines all 2260s from which mes¬ 
sages may be received. Cne POLL macro 
instruction must be included for each 
switched and nonswitched line in the 
system. 


| Name 

h- 


Operation! Operand 
- + - 


1 1 
|pollname|POLL 

1 

1 

f ((entry,...)] \ 


1 1 

1 1 

1 

1 

V [,AUTOPOL=jlj]/ 


1 1 

1 1 

1 

1 

\polladdr ( 

1 \ 


1 1 

1 

V 2740 J 



pollname 

Is the name of the polling list for 
the line. The name must be specified 
and must be identical to a name 
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specified in the sublist of the CPOLL 
keyword operand in the DTFCT macro 
instruction for the line group- In 
addition, the polling list defined 
irust be the polling list fcr the line 
indicated by the relative position of 
the name in the CPCLL sublist. 

entry,... 

Are the names of terminals on a 
nonswitched line in the order in which 
the terminals are to be polled. All 
the terminals specified must be on the 
same line. Bor a 2260-2848 Local, the 
sublist must contain the names cf all 
2260s in the line group frcm which 
messages may be received. Each name 
specified must he the name cf a TERN 
macro instructicn defining a single 
terminal entry. If the line (cr 
2260-2848 Lccal line group) is used 
for output only, or if the line is a 
WTTA line, the entry operands mustbe 
emitted. This operand is to be 
specified only for nonswitched lines 
cr fcr 2260-2848 Local line groups. 

AUTCPCL 

Must be specified if the line is an 
autopolled line. AUTOPOL=l specifies 
that the terminals are IBM 1030. 
AUTCPOL=2 specifies that the terminals 
are IBM 1050, or IBM 1060, or IEN 2740 
(type 274C cr 274D). This operand 
must be specified for nonswitched 
autcpolled lines only. 

polladdr 

Is the polling address tc be sent to 
any switched IEM 1050 terminal that 
dials the computer on the line 
represented by this polling list. All 
such terminals that can dial the 
computer on this line must recognize 
the same polling address. This 
operand must be specified in the 
hexadecimal representation of the 
device code appropriate to the type of 
terminal on this line. This operand 
is to be specified only for switched 
lines on which the computer can poll 
the terminal. 

nid 

Eescribes the identificaticn sequence 
cf the computer to be sent to any TWX 
cr WTTA terminal on the line 
represented by this polling list. 
Consists of the number of characters 
in the identification sequence, 
followed by the characters themselves. 
Ecth must be written as one continuous 
character string in hexadecimal 
notation; that is, the number cf 
characters in hexadexiroal, followed by 
the characters themselves in the 
hexadecimal representation of the 
8-level TWX cede or the 5-level code 


used by WTTA terminals. This operand 
is to be specified only for switched 
lines on which the TWX terminal can 
call the computer or for leased WTTA 
lines. 

For WTTA lines* nid is the number of 
characters of the CPU identification 
sequence* followed by the characters 
themselves. Both must be written as 
one continuous character string in 
hexadecimal notation; that is,, the 
number of characters in hexadecimal* 
and the characters themselves in 
hexadecimal representation of the 
5-level code used by the WTTA 
terminal- 

2740 

Must be specified for IBM 2740 
switched terminals (Types 274B* 274E* 
27 4G* and 274H) to be used for both 
input and output. For output only on 
these terminals, the operand must be 
omitted. 

Example : The following POLL macro 

instructions create the required polling 
lists for two nonswitched input lines, one 
nonswitched output line* one switched line 
on which IBM 1050s can dial the computer* 
one switched line on which TWX terminals 
can dial the computer,, one line on which 
the computer can dial TWX terminals* one 
autopolled line, and one nonswitched WTTA 
line. 


—- 

-T- - -T - 



|Name |Operation|Operand 

— 

-+-+- 


1 

j POLLINE1j POLL 

j (CHI,, BOS) 

2 

jPOLLINE2|POLL 

j (NYC,,BOS, NYC) 

3 

j OUTLINE3 j POLL 

1 

4 

|POLLINE4 j POLL 

| E215 

5 

j POLLINE5 j POLL 

| 0CB150FF72A3EB824B 


1 1 

1 D2E15088 

6 

j POLLINE6 j POLL 

j 03884DC9 

7 

|POLLINE7 j POLL 

j(PHI*WAS*ATL)* 


1 1 

| AUTOPOL=2 

8 

j POLLINE8 j POLL 

|0A020830352D38212D 


1 1 

| 0208 


.JL__ J_ __ 

_L- -- 


These macro instructions create polling 
lists used to: 

1. Poll the Chicago and Boston terminals 
in that order. 

2. Poll the New York, Boston* and New 
York terminals in that order. 

3. Represent the output-tonly line- 

4. Poll a switched IBM 1050 whose polling 
address is A0 (E215 is the IBM 1050 
device code representation of A0* in 
hexadecimal notation). 
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• Bend the computer's identification 
sequence, preceded and fcllowed fcy 
control characters, to any TWX 
terminal that calls the ccirputer on 
this line. The operand for the last 
FOIL iracrc is the device cede 
representaticn cf 12 CR LF DELETE N E 
li A R K CE If X-Cn, in hexadecimal 
notation. 

6. Send a "turnaround" sequence to any 
answering TWX which the CPU has dialed 
to turn cn the paper tape transmitter 
of the TWX. The operand of this POLL 
macro instruction is the transmission 
code representation of x-on 2 x-off, 
in hexadecimal format. 

7. Autopoll the Philadelphia, Washington 
and Atlanta terminals in that order. 

8. Send the CPU identification sequence 
(preceded and fcllowed by control 
characters) tc any WTTA terminal with 
which an identification exchange is to 
be performed. The operand for this 
PCII macro instruction is the 
device-code representaticn of: 


10 CR LF 3 6 0 - 5 0 CR LF 


in hexadecimal notation. 


BUFFERS 


The user must specify the size and 
number of the main storage areas required 
by QTAM for input and output buffering. 

How to define these buffers depends cn the 
type cf applicaticn. 

For a ncnaudic application, a buffer is 
specified by including one, and only one, 
EUFFER macro instruction in the message 
contrcl program. These main storage areas 
collectively form a buffer pool that is 
allocated to and used dynamically by £TAM 
to handle the transfer of message segments 
from and to all ccmmunication lines, 
direct-access queueing devices, and 
processing queues. 

All buffers in the buffer pocl are the 
same length. Since the entire header 
portion of a message must fit in the buffer 
that receives the first message segment, 
the length specified must be equal tc or 
greater than the size of the message header 
used plus 32 (the size of the header prefix 
generated and used by QTAM routines). 

Buffer request blocks (BREs) are CTAM 
contrcl blocks used to dynamically request 


buffers prior to their actual allocation 
from the buffer pool. The user should 
determine the number of BRBs required by 
the QTAM system. 

The number of BRBs required in the 
system is a function of a number of 
variable factors. The most important 
factor is the number of lines that are to 
be polled at the same time. The user 
should initially specify a value that 
represents the maximum number of BRBs that 
could be in use. If the user has specified 
a reasonable value in the BUFNO operand of 
the DTFQT macro instruction for each 
communication line group, the maximum 
number of BRBs he may need to specify in 
the BUFFER macro instruction may be 
calculated as follows: 

For each line group, multiply the number 
of buffers specified in the BUFNO 
operand by the number of lines in the 
group; add the products obtained for 
each line group. To this figure,, add 
one buffer for each MS destination queue 
and each MS process queue defined by 
message processing programs. The sum is 
the maximum value desired. 

Example : Assume three line groups, GPONE,, 

GPTWO,, and GPTHREE, consisting of five, 
twelve, and eight lines, respectively. The 
BUFNO operands of GPONE, GPTWO, and GPTHREE 
specify 3, 3, and 5, respectively. Also 
assume that there is one message processing 
program that defines one MS process queue 
and one MS-destination queue. The maximum 
number of BRBs to be specified in the 
BUFFER macro instruction is calculated as: 

(3x5) + (3x12) + (5x8) ♦ 1 + 1 = 93. 

The value calculated using the above 
formula represents the maximum number of 
BRBs that could be needed at one time. In 
actual operation,, the greatest number 
required at one time would be somewhat 
lower,, and the user may wish to specify a 
lesser value. Experience within the 
operating environment of a particular 
application can best demonstrate the 
practicality of specifying a lesser number 
of buffers. 

An exception arises when all the lines 
consist of dial lines or lines polled with 
the Auto Poll feature. In these cases the 
value derived above is the actual value 
that should be specified. In other cases 
experience within the operating environment 
of a particular application can best 
demonstrate the practicality of specifying 
a lesser number of BRBs. 

The number of buffers specified must be 
equal to or greater than the number in use 
at any one time. If the number of buffers 
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needed to acccirircdate message traffic at 
any time exceeds the number of buffers 
available, less of message data can occur. 
Therefore, the user should specify a 
sufficient number of buffers in the EtJFFFR 
macro instruction tc prevent this problem 
from arising under any expected operating 
conditions. 

Eecause the actual number of buffers 
that will be in use at any particular 
moment depends on several variable factors 
(whose cumulative effect varies more or 
less unpredictably), the user should 
initially specify a value that represents 
the maximum number that could be in use. 

This maximum value is related to the 
number of lines and the number of BFEs by 
following formula: 

Number of buffers = L + f(ERE - I) 
where I = number of lines 
ERE = number of BRBs 

f = a factor whose value is 
between 0 and 1. 

For small systems with few lines, the 
factor f approaches one. For larger 
systems a value of 0.5 might be adequate. 
Experience within the operating environment 
of a particular application can best 
demonstrate the appropriate value. 


Example : In the previous example there 

were 25 lines and 93 BRBSo A reasonable 
number of buffers for most applications 
would be 


number of buffers = 25 + 0.5(93 - 25) = 59. 


Management of data buffers is an 
important factor in running a QTAM system 
with optimum efficiency- There are four 
factors to be considered in weighing the 
trade-off of time and main storage: 


1. The user must specify the correct 
number of buffers to assure no loss of 
or undue delay of data. 

2. The user must select the size of the 
buffer to accommodace his messages. 

3. The user must decide on the number of 
BRBs needed for a reliable system. 

4. The user must decide on the number of 
BRBs to be assigned each line (set in 
BUFNO operand of DTFQT macro 
instruction). 

Figure 11 is provided to aid in deciding 
the effect of these factors. The figure 
shows the advantages in specifying more or 
less of the quantity with other considera¬ 
tions equal. 
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QUAN TIT* 


1 


ADVANTAGES 


larger buffers 


1. Requires fewer buffers for a message,, resulting in less 
overhead by QTAM to manipulate the buffers, 

2. Decreases the probability of losing data, since there is 
less chance of missing a program controlled interrupt. 

3. Makes better use of disk tracks if buffers are filled. 

4. Decreases the disk time, since there are fewer disk accesses. 


H 


smaller buffers 


1. Requires a shorter amount of time to fill up buffers. This 
results in more dynamic use of main storage,, and hence main 
storage is net tied up unprofitably. 


2. Increases likelihood of filling the entire buffer* therefore 
making better use of main storage. If a message does not 
fill up the buffer (as in larger buffers), main storage is 
wasted. 


more buffers 


fewer buffers 


1. Decreases the chance of losing data of incoming messages. 

2. Assures that outgoing messages are not delayed because they 
are waiting for a buffer. 

3. Allows more CPU time for other tasks. 


H 


1. Uses main storage more efficiently. No more buffers than the 
amount needed for incoming and outgoing messages are used* 
thus speeding throughput and saving main storage. 


H 


more EREs per line 


1. Reduces the chance of losing data due to a missed program 
controlled interrupt. 

2. Saves main storage if low activity allows fewer buffers than 
EREs to be specified. 


H 


fewer BRBs per line 


1. Saves buffers. Since there are as many buffers used at one 
time, when transmitting or receiving on a line* as there are 
EREs assigned tc the line, buffers are not unnecessarily tied 
up. (Only one buffer per line is assigned during polling.) 


figure 11. Aids in Specifying ERBs and Buffers 


BUFFER Macro Instruction 


EUFFER specifies the main storage buffer 
areas reguired by QTAM. The buffers are 
allocated to CTAN as a block cf main 
storage called the buffer pool. 


r - r -1--- 

| Name|Operation|Operand 

|.- 1 - 1 -- 

| (BUFFER jnnn,length!,irmir] [„brt] 

i-1--i-.- 


nnn 


length 

Is the length, in bytes* of each 
buffer. All buffers in the buffer 
pool are the same length. The length 
specified must equal or exceed the 
length of the longest message header 
used in the system plus 32 (the size 
of the header prefix generated by 
QTAM). The length of the message 
segment size used in the system is 
| based on the buffer length. The 

*) ( maximum allowable buffer length is 276 

j bytes. The value specified (if any) 

J in the optional operand of the LPSTART 

macro instruction must also be 
considered in determining the value of 
the length operand (see the LPSTART 
macro instruction description). 


Is the number cf buffers tc be 
reserved (see the example calculation 
above). 
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iririr 


brb 


Is the number of channel ccirmand words 
£TAM must generate for sending the 
idle characters specified by the PAUSE 
iracro instructions in the IPS sections 
cf the message control program. The 
number of CCWs required depends on a 
number of variables whose cumulative 
effect changes during system 
operation. (The principal factors are 
the number of appearances in messages 
cf each control character that 
requires idle character insertion, and 
the number of lines over which 
outgoing messages are being sent at 
the moment.) Eecause determining the 
actual number cf CCWs that could be 
needed at any given moment is 
impractical, the user should initially 
specify a "worst-case" value (that is, 
a value representing the maximum 
number of CCWs that could be required 
under any operating condition). This 
value may be calculated as follows: 


mmrn = L ± (I*) ♦ I 2 (I 2 ) + ... L n (I n ) 

where L equals the number cf lines in 
the line group and I equals the 
expected number of appearances cf 
control characters per outgoing 
message-filled buffer, for which idle 
character insertion is required? L(I) 
is calculated fcr each of the line 
groups 1 through n. Insertion cf idle 
characters is net required for 
terminals in a 2260-2848 Lccal cr 
Pemcte line greup? therefore* this 
operand may be emitted if this is the 
only type cf line group defined in a 
message control program. If this 
operand is emitted, no CCWs are 
generated and the PAUSE macro cannot 
he used. 


Example : Assume that the LPS fcr the first 
line group includes a PAUSE macro 
instruction that causes insertion of idle 
characters each time a NL (new line) 
control character is encountered in an 
outgoing message-filled buffer. Also 
assume that the expected number of 
appearances of this control character in an 
outgoing buffer is two. I therefore equals 
2. If the line group consists cf five 
lines. Lid*.) equals 5(2). If the system 
includes two ether line groups for which 
L(I), calculated similarly, equals 3(3) and 
7(4)* then mmrn = 5(2) ♦ 3(3) + 7(4) = 47. 

In most applications this "wcrst-case" 
value will considerably exceed the actual 
number cf CCWs required. Therefore, the 
user may reduce the value during system 
testing. If this operand is emitted, zero 
is assumed. 


Is the number of buffer request blocks 
(BRBs) to be reserved. (See the 
sample calculation above.) This 
number must be greater than or equal 
to the number of buffers specified. 

If this operand is omitted or the 
number specified is less than the 
number of buffers, the number of BRBs 
is set equal to the number of buffers. 
If this operand is specified and the 
mmrn-integer is omitted, this operand 
must be preceded by two commas. 

Example : Assume a system in which: 

1. 59 buffers of 100 bytes each are 
required. 

2. The number of CCWs required for 
insertion of idle characters is 47. 

3. The number of BRBs required is 93. 

The BUFFER macro instruction would then 
be written: 

BUFFER 59,100*47,93 


FILE INITIALIZATION AND ACTIVATION 


The file initialization and activation 
section of the message control program 
begins with an OPEN macro instruction and 
ends with the ENDREADY macro instruction. 
Within the message control program, this 
section must precede the LPS section. When 
the instructions in this section have been 
executed, the system is ready to handle 
message traffic. 

The OPEN macro instruction completes the 
initialization for and activation of the 
DASD message queues, communication line 
group, message log* and checkpoint records 
files. Opening a communication line group 
file causes all lines in the line group to 
be prepared for operation. The lines are 
activated automatically for message 
transmission. 

The ENDREADY macro instruction must be 
the last instruction in the file 
initialization and activation section. 

When ENDREADY has been executed, the system 
is ready to handle message traffic. The 
expansion of this macro instruction causes 
a branch to the IBM-provided logic that 
supports the message control program, where 
procurement of the first message is awaited 
(for nonaudio lines, the first message 
procured can be either a message coming in 
from a terminal, or a message being sent to 
a terminal by a message processing program. 
When the first message is procured, control 
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is returned to the IPS section cf the 
message control program for handling of the 
message. For this reason, no executable 
code nay be included between ENEREADY and 
the UPSTART macro instruction that begins 
the IPS section. 

Cnee the IPS is initially entered via 
the expansion of the ENEREAEY macro 
instruction, execution in the message 
control program is restricted tc the IPS 
section; that is, the EPS is continually 
reentered to handle iressages entering and, 
except for the audic messages, leaving the 
computer as long as the message control 
program is active, reactivation of the 
message control program and the 
telecommunications system is accomplished 
by closing the message control program 
files. The section, reactivating the 
Teleccmmunications System , contains a 
discussion of the procedures necessary tc 
terminate the message control program. 

The STARTIN, CCPYC, CHNGF, CCPYT, CHNGT, 
and CCFYQ macro instructions may be used in 
the initialization and activation section 
of the message control program. This is 
useful if the user wishes to modify the 
status cf his system at the time the 
message control program is initiated. If 
any of the above nacre instructions are 
used in this section, they must precede the 
ENEREAEY macro instruction. Generally, 
however, these macro instructions are 
employed in a message processing program 
(in the foreground-two or background 
partition) so that the status of the system 
can be dynamically examined and modified as 
needed. 


OPEN Macro Instruction 


OPEN is used in the message control 
program to complete the initialization and 
activation of the DASD message queues, 
communication line greup, message log, and 
checkpoint records files. All these files 
can be opened separately or with one OPEN. 
However, the user must open the DASE 
message queues file, if any, before any 
other file used by CTAM. If the Checkpoint 
Restart feature is used, the EASD 
checkpoint records file must be opened 
after the DASE message queues file. The 
user specifies, as the operands of the OPEN 
macro instruction, the names cf the ETF 
tables for the files. 

If the DTF table for a communications 
line group is specified, the OPEN routine 
completes the initialization for all lines 
in the line group and automatically 
activates the lines for message 
transmission. If the TYPEFLE keyword 


operand of the DTFQT macro instruction for 
a nonswitched line group specifies INPUT or 
CF.END (input and output), OPEN performs 
initialization procedures necessary for 
polling on those lines in the line group 
that have an active polling list with 
terminal entries. Polling on these lines 
commences after execution of ENDREADY. If 
a line does not have an active polling list 
with terminal entries, or if TYPEFLE=OUTPUT 
is specified, polling is not initiated. If 
the OPEN is for a switched line group with 
TYPEFLE=INPUT or CMBND, the OPEN routine 
issues commands to enable each access line 
in the line group. 


If the communications line group being 
opened is for a 2260-2848 Local, the Open 
routine causes the CCB for each 2260 Local 
from which messages are to be received to 
be placed on the DOS channel scheduler 
queue. When this initialization procedure 
is completed, QTAM is prepared to service 
read requests (signalled by Attention 
interrupts) from each 2260 local defined in 
the polling list for the line group. 
Attention interrupts that arrive before 
Open is completed or from 2260 Locals not 
defined in the polling list are ignored. 


If the Checkpoint Restart feature is 
used, the DASD checkpoint records file is 
examined. If the file has been properly 
closed, initialization is completed for 
placement of checkpoint records on the 
DASD. If the file has not been closed, a 
restart operation is performed. Restart 
reestablishes the queues and the 
telecommunications network to the status it 
had at the time of the most recent 
checkpoint, except for the audio lines. If 
the file has not been closed, because of a 
system failure, and the user does not wish 
to perform a restart operation, he must 
reinitialize the checkpoint records file 
before loading the program. 


The formats for the message queues file 
and for the checkpoint records file are 
checked when the particular file is opened. 
If the file is formatted incorrectly, an 
error message is provided, and the job is 
cancelled. 


If a message log DTF table is specified, 
initialization is completed for placement 
of messages on the device to be used for 
logging. 

f -P- T -T 

|Name |Operation! Operand | 

j [symbol)(OPEN | filename,... | 

L_-L—__-L_.___J 
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symbol 

Is the name cf the macro instruction. 
The name is optional. 

filename 

Specifies the name of the ETF table 
associated viith the file being opened. 
Several files may be opened with one 
OPEN by entering their file names as 
operands. 

If register notation is used f any general 
register in the range 2 through 12 may be 
specified. The programmer must load the 
address in the register before issuing the 
OPEN. 

Note : It is permissible to intermix 

register notation and relocatable 
expressions in the same OPEN. Eor example: 

r- T - t-1 

|Name |Operation(Operand | 

K-+--f-1 

(OPENER(OPEN IDISKFILE,(3), (4),LOG j 

L-J.- JL -J 

Examples : shown below are two examples 

that illustrate the two methods that can be 
used to open the message control program 
files, The first example opens each file 
with a separate OPEN macro instruction? the 
second opens the files collectively. The 
CASE message queues file (DISKFILE) is 
opened first as required in both examples: 


area. ENDREADY saves the user's registers 
in this area by standard register saving 
conventions. When control returns to the 
user at the address specified in the EOJAD 
keyword operand of the DTFQT for the first 
file opened in the message control program* 
the registers (except for register 14) are 
restored. No operand is required. 


Name|Operation|Operand 

_ . l .4 


1 

_J 

jENDREADY j 

- X --X-- 


-1 

1 

_1 


LINE PROCEDURE SPECIFICATION (LPS) 


The procedure followed by a message 
control program in operating upon messages 
being received from or, except for audio 
lines* sent to terminals is defined by a 
line procedure specification (LPS). An LPS 
is a sequence of IBM-provided statements 
called LPS macro instructions. The user 
must provide an LPS for each communication 
line group in his system. However* one LPS 
may be used by more than one line group if 
each of the groups requires identical 
message control procedures. 

The purpose of the LPS is to define 
macro-introduced routines that: 


r - T - T ---T 

(Name|Operation|Operand | 


t— 

1 

| OPEN 

—4-— - — 

|DISKFILE 

- .) 

1 

1 

|CEEN 

j LKGRCUP1 

1 

1 

(CPEN 

j LKGBCUP2 

1 

1 

|CEEN 

ILCGFILE 

1 

l_ 

—-1 _ 


__ _ _J 


r- r - t - 

| Name|Operation|Operand 

t- 4 - + - 

I |OPEN |DISKFILE,LNGRCUI1 

j j j LNGRCUP2,LOGFILE 

l-Jl-X_ 


ENDREADY Macro Instruction 


The file initialization and activation 
section must be ended by an ENDREADY macro 
instruction. ENDREADY is essentially a 
wait-type instruction; the event awaited is 
the procurement cf the first message. Only 
one ENDREADY macro instruction can be 
included, and it must be the last in the 
group of file initialization/activaticn 
instructions. Prior to issuing ENDREADY, 
the user must ensure that register 13 
contains the address cf an 18-wcrd save 


1. Examine and process control 
information in the message header. 

2. Perform functions necessary to prepare 
a message segment for processing or 
transmission. 

Preparing an LPS consists primarily of 
selecting the appropriate IBM-provided 
macro instructions and writing them in a 
| particular sequence* according to the 
-j requirements of the installation and of the 
j line group. The user may also insert his 
own coding sequences to better adapt QTAM 
to his requirements.. Considerations such 
as the message header formats* the 
processing requirements for various types 
of messages (if messages having different 
handling requirements are directed to the 
same LPS)* the type of terminal in the line 
group* and whether the LPS is operating on 
messages from switched or nonswitched lines 
must be carefully analyzed. 

Two major types of macro instructions 
are used in the LPS: functional macro 
instructions and delimiter macro 
instructions. In general* the functional 
macro instructions perform the specific 
operations required on messages directed to 
the LPS. Delimiter macro instructions for 
nonaudio lines classify and identify 
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sequences of functional macro instructions. 
Delimiter macro instructions also direct 
control to the appropriate sequence, 
according to whether the message segment is 
incoming or outgoing, and whether it is a 
header segment cr a text segment. 


COMPONENTS OF THE LFS 


The IPS is divided into two major groups 
of iracrc instructions 2 the Receive group, 
which handles incoming messages; and the 
Send group, which handles outgoing 
messages. In the ceding of the LPS, the 
Receive group must precede the Send group. 
Each cf the majer groups is further divided 
into three coding subgroups. The Receive 
Segment and Send Segment subgroups contain 
macro instructions concerned with all 
portions (both header and text) of incoming 
and outgoing messages, respectively. The 
Receive Header and Send Header subgroups 
contain macro instructions concerned cnly 
with the headers cf incoming and outgoing 
messages. Macro instructions in the End 
Receive and End Send subgroups perform 
error-handling procedures for incoming and 
outgoing messages. 

The Receive Header and Receive Segment 
subgroups may each be used more than cnce 
within the Receive group. Similarly, the 
Send Header and Send Segment subgroups may 
be used more than cnce within the Send 
group. For example, an application might 
require that different operations be 
performed for several different types of 
messages directed tc the IPS. Each cf the 
message types could require a different 
header format. In such a case, there could 
be a separate Receive Header subgroup to 
process the header cf each message type. 

The user can include in his header formats 
a special message-type character for each 
type cf message. The MSGTYPE functional 
macro instruction can be used tc examine 
the message-type character and direct 
control to the appropriate Receive Header 
subgroup. 

The sequence cf the Receive Header and 
Receive Segment subgroups within the 
Receive greup, and the sequence of the Send 
Header and Send segment subgroups within 
the Send group, may depend on which 
functional macro instructions are specified 


within the subgroups. For example,, assume 
that the TIMESTMP macro is included in the 
Receive Header subgroup, and that the TRANS 
macro is included within the Receive 
Segment subgroup. The TIMESTMP macro 
enters the time of day into the message 
header in EBCDIC form, and the TRANS macro 
translates all message segments from 
transmission code into EBCDIC.* It is 
evident that the EBCDIC time information 
must be inserted afte,r the header has been 
translated to EBCDIC, not before. The 
TRANS-introduced translate routine must 
therefore be executed before TIMESTMP, 
hence, the Receive Segment subgroup, which 
contains the TRANS macro, must be executed 
before the Receive Header subgroup. 

The End Receive and End Send subgroups 
| may each be used only once and must be the 
last sections within the Receive and Send 
groups, respectively. 

If only the IBM-provided macro 
instructions and associated 
macro-introduced routines are used in 
coding an LPS, the Receive Header subgroup 
is mandatory. The user may omit any other 
subgroup if it is not required for a 
particular application. For example, the 
Receive Segment and Send Segment subgroups 
may be omitted in a message switching 
application if all terminals involved 
operate in the same device code (that is, 
translation of the message text is not 
required) and none of the other functions 
restricted to use in these subgroups is 
desired. Any or all coding subgroups may 
be omitted if the user prefers to write his 
own routines for the functions he requires. 
An LPS must contain, as a minimum, the 
| LPSTART, POSTRCV, ENDSEND, AND POSTSEND 
delimiter macro instructions to provide the 
linkage between the LPS and IBM-provided 
logic that supports the message control 
program. An LPS must also contain either a 
ROUTE or a DIRECT macro instruction. The 
use of all other functional macro 
instructions is optional. 

Note : Any user code within the LPS should 

be re-entrant 

Figure 12 shows the various coding 
subgroups that can be included in an LPS, 
the delimiter macro instructions associated 
with each subgroup, and the functional 
macro instructions (in alphabetical order) 
that can be used in each subgroup.* 
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RECEIVE MACRO INSTRUCTIONS 


Coding 

Subgroup 


Receive 

Segment 


Receive 


Reader 


End 

Receive 


Delimiter 


LPSTART 1 


RCVSEG 


RCVHDR 


ENDRCV 


COUNTER 4 * 

DATESTMP 2 

DIRECT 4 

ECA 2 

LCGSEG 

MODE 2 

MSGTYPE 2 

CPCTL 2 4 
PCLLIMIT 4 
ROUTE 2 
SEQIN 2 

SKIP 2 

SOURCE 2 

TIMESTMP 2 

TRANS 


CANCELS 

ECB 

EOELC 

EFRMSG 4 

POLLIMIT 4 

REROUTE 4 


I I 
H h 


Functional 


EREAKCFF 
COUNTER 3 4 
LCGSEG 
TRANS 


SEND MACRO INSTRUCTIONS 


H 


Coding 

Subgroup 


Send 

Segment 


Send 

Header 


h- 


End 

Send 


Delimiter 


SENDSEG 


SENDHDR 


+-- 


ENDSEND 1 - 


POSTSEND 1 


J 


Functional 


COUNTER 4 

LOGSEG 

PAUSE 

TRANS 


COUNTER 4 

DATESTMP 2 

LOGSEG 

MODE 2 

MSGTYPE 2 

PAUSE 

SEQOUT 2 

SKIP 2 

TIMESTMP 2 

TRANS 

WRU 


EOB 

EOBLC 

ERRMSG 4 

INTERCPT 4 

REROUTE 4 

WRU 


- 4 - + - 

j PCSTRCV 1 | 

- X -JL- 

^Required delimiter macro instruction, 

functional macro instruction must be in the same relative order as the corresponding 
message-header field on which it operates. 

3 CCUNTER can he used in RCVSEG for nonswitched lines only. 

4 These macro instructions may require optional terminal table subfields. 


.j 


Figure 12. Ncnaudic line Procedure Specification Macro Instructions 


DELIMITER MACRO INSTRUCTIONS 


Delimiter macro instructions group the 
functional macro instructions into the 
various subgroups. They also perform 
initialization and control functions within 
the IPS. 

The LPSTART macro instruction identifies 
the beginning of the IPS and must be the 
first instruction in every LPS. The code 
generated by the expansion of LPSTART 
determines whether the message segment 


entering the LPS is incoming or outgoing 
and directs the segment to the Receive 
group or the Send group accordingly. In an 
application that directs multisegment 
messages to the LPS* it is necessary that 
the functional macro instructions in the 
header processing subgroups be executed 
only where the message segment being 
handled contains the message header. The 
expansions of the RCVHDR and SENDHDR 
delimiter macro instructions cause the 
header processing subgroups to be bypassed 
when a message segment contains text only. 
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PCSTRCV and PCSTSEND identify the ends 
of the Receive group and the Send group, 
respectively. These delimiters, along with 
LPSTART, must appear in every LPS. Each of 
the remaining delimiters is required only 
if the user chooses tc include in the LPS 
the ceding subgroup associated with that 
delimiter. 


FUNCTIONAL MACRO INSTRUCTIONS 


Functional macro instructions perforin 
the specific operations required on message 
segments. These functions include: 

• Message editing (code translation and 
insertion of time of day, current date, 
and message sequence numbers in message 
headers). 

• Checking validity of source and 
destination cedes in message headers. 

• Routing messages to specified 
destinations. 

• Maintaining legs of messages on an 
auxiliary storage device. 

• Checking fer errors in message 
transmission and taking corrective 
action. 

Functional macrc instructicns that 
perform operations related to an entire 
message segment may appear at any point 
within the coding subgroup in which they 
are used. All functicnal macro 
instructions in the Receive Segment, Send 
Segment, End Receive, and End Send 
subgroups are included in this category. 

The majority of the functicnal macro 
instructicns in the Receive Header and Send 
Header subgroups perform functions that 
concern a specific header field. Macro 
instructions of this type involve either: 

1. Use of a QTAM scanning routine tc 
determine the contents of a specific 
header field (SEQIN and SOURCE, for 
example); cr 

2. Insertion cf a new field in the 
message header (TIMESTMP and SEQCUT, 
for example); cr 

3. Making of a decision at some point 
during header processing (MODE and 
MSGT2PE, for example). 

These macro instructions must appear in 
a specific sequence dependent on the format 
of the message headers. 


In planning a format for message 
headers, the user may arrange the various 
header fields in any desired order. Macro 
instructions involving scanning, insertion 
of a field, or making a decision must be in 
the same relative order as the 
corresponding message^header fields on 
which they operate. Figure 13 indicates 
the functional macro instructions that must 
be sequenced in this manner. 

Note : The entire header of each message 

must be contained within the buffer that 
receives the first segment of the message 
(see the BUFFER macro instruction 
description). The message header must not 
| exceed 244 bytes. 

Some functional macro instructions that 
use the scanning routine provide the option 
of specifying the length of the header 
field to be scanned (ROUTE and SOURCE, for 
example). If the user does not specify the 
length, the field is assumed to be of 
variable length and must end with a blank 
character. No blank character may appear 
within the field because it will be 
mistaken for the end-of-field delimiter. 

If the field length is specified, the field 
to be scanned need not end with a blank 
character, and may contain embedded blanks. 


ERROR-HANDLING FUNCTIONAL MACRO 
INSTRUCTIONS 


Four functional macro instructions 
(CANCELM, ERRMSG, INTERCPT, and REROUTE), 
called error-handling macro instructions, 
permit the user to test for any condition 
for which he wishes appropriate action to 
be taken. These macro instructions are 
used in conjunction with the error 
half-word for the communication line 
involved and/or the information obtained 
from the device in error by a SENSE 
command. The error half-word consists of 
sixteen bits, each of which (except unused 
bits) indicates the presence (when 1) or 
absence (when 0) of a specific error or 
condition that has affected or may affect 
successful transmission of a message. The 
meaning of each of the bits is explained in 
Figure 15, and the meaning of the bits in 
the sense information is explained in the 
pertinent telecommunications control unit 
publication indicated in the Preface . 

The user specifies in each error 
handling macro instruction used a half-word 
bit configuration called a mask. At the 
completion of transmission of each message 
(or each block of a message), the mask is 
compared to the error half-word. If a 1 is 
detected in any bit position of both the 
mask and the error half-word, the function 
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specified by the iracro instruction is 
performed* A zerc is specified in a mask 
bit position when the error condition 
represented by the corresponding position 
in the error half-word is to be ignored. 
The user iray cause the function specified 
by the macro instruction to be performed 
unconditionally (that is, for all messages 
or message blocks) by specifying a mask 
consisting entirely cf zeros. 


The user roust carefully analyze the 
reguirements cf his application to 
determine which errors or conditions must 
be detected and which can reasonably be 
ignored without degrading the performance 
of his system.. The four error-handling 
macro instructions provide varying methods 
by which corrective or control functions 
can be initiated when an error has been 
detected. The ERRMSG macro instruction is 
used tc send an appropriate message to a 
designated destination when any error 
specified by the mask has occurred. For 
example, if an invalid destination code is 
detected during receipt of a message, the 
ERRMSG macro instruction can be used to 
send a message tc the originating terminal 
stating the nature cf the error and 
requesting that the message be corrected 
and sent again. The INTERCFT macro 
instruction suppresses the sending of 
messages to a terminal when any error 
specified by the mask has been detected? it 
is normally used to withhold transmission 
to a terminal that has become inoperative. 
The section, FUNCTIONAL MACRO INSTRUCTION 
DESCRIPTIONS (NCNAUDIC LINES) , contains 
detailed discussions of these and the other 
error-handling macrc instructions. 


The user may in the LPS access directly 
the error half-word and the sense 
information which are contained in the LCB 
by using the name IJIQLEHW for the error 
half-word and the name IJLQLSEN for the 
sense information. Prior to passing 
control tc the IPS, QTAM places the address 
of the ICE associated with the line 
involved into register 4. The expansion of 
the LFSTART macrc instruction establishes 
this register as the base for the LCE DSECT 
generated by the expansion of the TERMTBL 
macro instruction. 


When entering a message from an IBM 1050 
terminal, a terminal operator has the 
capability cf cancelling the message 
immediately by pressing the alternate and 
cancel keys and then entering ECE. The 
terminal is repolled at once so that the 
message may be reentered if desired. 


THE SCAN POINTER 


In QTAM, general register 5 is used as 
the scan pointer register, maintaining a 
pointer to the current field in the message 
header. From the user*s standpoint, this 
pointer is the key to QTAM. Through the 
use of QTAM macro instructions, the user 
manipulates this pointer, examines fields 
in the header, and makes decisions based on 
the contents of these fields* In designing 
a QTAM message control program, the user 
must be constantly aware of the header 
field about to be processed. 


QTAM macro instructions perform many 
varying functions from verifying sequence 
information to placing messages on 
destination queues. The user can design a 
simple message switching application using 
QTAM macro instructions only, and no user 
code. More sophisticated applications may 
xequire that the user use the scan pointer 
in his routines. 


Basically, two types of LPS macro 
instructions cause the scan pointer to be 
moved (Figure 13). 

1. Certain macro instructions move the 
scan pointer along until a 
user-specified character sequence is 
found (e.g. SKIP X'35*). After these 
macro instructions are completed, the 
scan pointer is positioned to the last 
character in the sequence. 

2. Other macro instructions move the scan 
pointer a certain number of 
characters. The number of characters 
is determined in three ways: 

a. Certain macro instructions have a 
fixed count of characters 

(DATESTMP) or an assumed count to 
be used if no other count is 
supplied (TIMESTMP). When this 
type of macro instruction is 
completed, the scan pointer points 
to the last character to satisfy 
the count. Any blank characters 
encountered are skipped. 

b. With certain macro instructions, 
the user may specify a number of 
nonblank characters to be 
considered as the next field 
(ROUTE 3)i When these macro 
instructions are completed, the 
scan pointer is positioned to the 
last character which satisfies the 
count. The user may send in RA L, 
and the field is still considered 
RALo The scan pointer points to 
the L. 
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c. With certain macro instructicns r 
the field may be variable in 
length (SCtFCE). In this 
situation, the field length is not 
specified by the user. The scan 
pointer is moved forward past any 
blanks which might precede the 
field. The field is then scanned 
for a blank delimiter. When these 
iracrc instructions are completed, 
the scan pointer points to the 
blank delimiter which follows the 
field. 

When a message is first received for 
processing by the receive portion of the 
LPS, the space reserved by the LPSTAFT 
macro instruction fcr expansion has teen 
filled with idle characters (X , 17 f ). The 
scan pointer is positioned to the last of 
these idle characters. If no idle 
characters were specified in the LPSTAFT 
macro instruction, the scan pointer points 
to the last byte cf the header prefix. 

After the receive section of the IPS is 
completed, the position of the scan pointer 
is saved in the ESPT field of the header 
prefix, and the message is placed on the 
queue fcr its destination. When the 
message comes off the destination queue to 
go through the send portion of the IPS, the 
scan pointer is restored to its former 
position, pointing tc the last character of 
the last field processed. Additional 
status information may be inserted into the 
header before the message is finally 
transmitted. 

A message processing program may 
generate a response message containing idle 
characters before the header fields. When 
this message is retrieved from the 
destination queue tc be transmitted,, the 
scan pointer points to the last of these 
idle characters. If no idle characters are 


in the message, the scan pointer points to 
the last character in the header prefix. 
Macro instructions in the SENDHDR section 
of the IPS bypass these idle characters in 
scanning for the beginning of the header 
field. 


Macro instructions in the LPS are placed 
in the same order as the fields of the 
header on which they act. The scan pointer 
controls access to these fields,, normally 
progressing across the header from left to 
right as the various macro instructions are 
executed. The user may use the scan 
pointer in his own routines to perform 
header analysis not provided by QTAM. 
However, he must take the responsibility of 
positioning the scan pointer to its proper 
position before executing the next QTAM 
macro instruction. This may be effected by 
such instructions as LA 5„4(5), which moves 
the scan pointer four bytes; or,, in the 
case of fixed format headers,, the scan 
pointer may be repositioned relative to the 
beginning of the buffer by using the 
address in general register 6. Another 
method would be to scan the header for a 
specific character or character sequence 
(SKIP macro instruction) arid reposition 
the scan pointer there, although this 
procedure may be time consuming because of 
the comparisons needed to find the desired 
position in the header. 

Note: When a message is PUT from a message 

processing program to a message control 
program, the scan pointer is positioned to 
the last idle character in the header. 

This differs from the position of the scan 
pointer for other messages being handled in 
the Send portion of the LPS. Therefore it 
is recommended that the scan pointer be 
positioned to the last position of the 
header of all messages being handled in the 
Send portion of the LPS. 
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Before DATESTMP is issued: 
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Position of Scan Pointer is at: 

(a) After LPSTART and RCVHDR have been issued. 
© After SKIP X 1 ]5* has been issued. 

© After SOURCE has been issued. 

© After ROUTE 3 has been issued. 


After DATESTMP is issued: 
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The DATESTMP macro instruction causes the 
header contents to be shifted 9 spaces left to 
make room for the date. The date is inserted 
and the scan pointer is positioned at (e) . 


Figure 13. Scan Fointer Positions 


ARRANGEMENT OF LPS MACRO INSTRUCTION 
DESCRIPTIONS 


There are two irajcr types of LPS iracro 
instructions: 

1. Delimiter macro instructions 

2. Functional iracro instructicns 

Since the decision as to what iracro 
instructions should he included in 
constructing an LPS and how they should be 
sequenced depends greatly on the particular 
application, no attempt is made to discuss 
the macro instructicns in any lcgical 
order. The macro instruction descriptions 
are arranged alphabetically by major type 
for easy access. 

Note : The user is cautioned against 

transferring control between macro 
instructions within the LPS. A 


user-written branch to a macro instruction 
may require that the user also perform 
functions (such as register saving and 
restoring) normally provided by the IBM 
supplied coding. Since user-'written 
branches are the exception rather than the 
rule, the name fields in the macro 
instruction formats for the LPS macro 
instructions (with the exception of 
LPSTART) have been omitted. 


DELIMITER MACRO INSTRUCTION DESCRIPTIONS 


End Receive (ENDRCV) Macro Instruction 


The ENDRCV macro instruction identifies 
the beginning of the End Receive coding 
subgroup of the LPS. The functions 
specified in this subgroup are performed 
after an entire message has been received 
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by the computer. If EOE or ECBIC is 
specified, the functional macros in this 
subgroup that precede ECE or ECEIC are 
performed after each message tlcck has been 
received. Functional macros following ECB 
or ECEIC are performed only after the 
entire message has been received (see the 
descriptions of the ECB and ECBIC macro 
instructions). 

If the End Receive subgroup is used* it 
must begin with the ENDRCV macrc 
instruction. It must be the last subgroup 
in the Receive grcup and can be used only 
once in an IPS. No operand is required. 


r- t--- 1 

| Operation|Operand | 

t - + - i 

j ENDRCV j j 

L_Jl---J 


End Send (ENDSEND) Macro Instruction 


The ENDSEND macro instruction identifies 
the beginning of the End Send subgroup of 
the IPS. The functional macro instructions 
included in this subgroup are executed 
after an entire message has been sent by 
the computer, or after a message block has 
been sent if ECE or ECBIC is included as 
the last macrc instruction in the subgroup 
(see the descriptions of the ECE and ECEIC 
macro instructions). Functional macros 
following ECE or ECEIC are performed only 
after the entire message has been sent. 

If the End Send subgroup is included, it 
must begin with the ENDSEND macro 
instruction. It must be the last subgroup 
in the Send group and can be used only once 

in the IPS. No operand is required. 

r- T --i 

|Cperation|Cperand | 

h-+- i 

|ENDSEND j j 

l_J._J 


line Procedure Specification Start 
(IPST3RT) Macro Instruction 


Receive group or the Send group,, 
accordingly. 


r - T - T - 1 

|Name |Operation! Operand | 

y -+-+-^ 

|lpsname|LPSTART | nn, 

I I 

| |TERM=(termcode...) 


i- 


jINTRCPT=fieldname 


_j 


lpsname 

Is the name of the macro instruction 
and is required. It must be the same 
as lpsname specified in the CLPS 
keyword operand of the DTFQT macro 
instruction for the line group. 


nn 

Is the total number of bytes to be 
reserved in the message header in the 
first buffer of each input message for 
insertion of time-of~day„ 
current-date, and output sequence 
number information,,including blanks 
(see TIMESTMP, DATESTMP W and SEQOUT 
macro instruction descriptions). If 
the messages are to be sent to a 
Western Union Plan 115A terminal,, the 
user should reserve one more byte to 
contain an initial EOA character., 
(Refer to End-^of-addyess in Appendix F 
for further information.) The number 
of bytes inserted in the LPS Send 
group that handles messages PUT by a 
message processing program is not 
included in this value. A leading 
zero is not required. If this operand 
is omitted, no space is reserved. The 
number of bytes reserved must be 
included in the calculation of the 
buffer size (see BUFFER macro 
instruction). 

termcode if ,... 

Is the identifying code for the 
type(s) of terminals that utilize this 
LPS. The parentheses are coded when 
the sublist consists of more than a 
single entry. For example,, 

TERM=(1050)• The following values can 
be included in the sublist: 


The I-PSTART macrc instruction provides 
an initialization procedure fcr the IPS 
LPSTART is required and must be the first 
macro instruction in every IPS. 

The code generated by the expansion of 
this macrc instruction cperand includes a 
test to determine whether the message 
segment entering the IPS is incoming or 
outgoing, and directs the segment to the 


1. 1030 = IBM 1030 terminals. 

2. 1050 = IBM 1050 terminals. 

3. 1060 = IBM 1060 terminals. 

4. 2848 = IBM 2848 control units 

(associated with remote 
IBM 2260 terminals). 

5. 2740 = IBM 2740 terminals. 
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6 . 83E3 = PIS'! 83E3 Selective 

Calling Stations. 


7. 115A = Western Union Elan 115A 

cutstations. 


8. TWX = ccirircn carrier TWX 
stations. 


9. 2260 = IEM 2260 Local terminals 


10. WTTA = WTTA teririnals 
INTRCPT 

Is the name cf the optional subfield 
cf the terminal table specified in the 
OPTION macro instruction fcr use by 
the INTERCFT iracro instruction. Must 
be specified if the intercept function 
is used. 

Example: Suppose that this LPS applies to 

IEM 1050 and IEM 2740 terminals. Suppose 
further that TIMESTMP and SEQUT macro 
instruction are to be included in this LPS. 
Allowing 6 spaces fcr the time-cf-day 
(hours and minutes) and 4 spaces for the 
output sequence number (numbers up to 999), 
then the LPSTART macro may be ceded thus: 

LPSTWC LPSTART 10,TERM= (1050,2740) 

The various LPSTART macro instructions 
identify the start of the various LPS 
portions of the message control program. A 
program handling message for TWX and IBM 
1050 and 2740 terminals may be organized as 
shown in Figure 14. 


Pest Receive (PCSTRCV) Macro Instruction 


|QTAMMCP START 

| • (file definition,, control, 

I • and initialization macro 

j • instructions) 

| ENDREADY 

j LPSTWX LPSTART 9 , TERM=(TWX) 

j • (delimiter and functional 

j • macro instructions for TWX 

j • lines) 

| POSTSEND 

|LPS10 5 0 LPSTART 9,TERM=(1050*2740) 
j • (delimiter and functional 

| • macro instructions for 

| • lines with 1050 and 2740 

j • terminals 

j POSTSEND 

j CLOSE 

j EOJ 

I 

| Alternatively* the above program 
j could also be arranged as follows: 

I 

j MCP2 START 

j • (initialization) 

j ENDREADY 

j • (control macro instruc- 

j • tions) 

|LPS1050 LPSTART 9,TERM=(1050,2740) 
j • (functional and delimiter 

j • macros for lines with 

j • 1050 and 2740 terminals) 

j POSTSEND 

|LPSTWX LPSTART 9*TERM=(TWX) 
j • (functional and delimiter 

| • macro instructions for TWX 

| • lines) 

| POSTSEND 

j • (file definition and 

j • control macros 

j • DTFQT* BUFFER* etc.) 

j CLOSE 

j EOJ 

L_J 

Figure 14. Use o£ LPSTART in a Message 
Control Program 


The PCSTRCV macro instruction identifies 
the end of the instruction sequence that 
processes incoming messages; that is, 

instructions in the Receive Segment, Post Send (POSTSEND) Macro Instruction 

Receive Header, and End Receive coding 

subgroups. 

The POSTSEND macro instruction 

Cne PCSTRCV macrc instruction is identifies the end of the instruction 

required in each LPS, and it must be the sequence that processes outgoing messages; 

last instruction in the Receive group. No that is,, instructions in the Send Header* 


operand is required. Send Segment,, and End Send coding 

subgroups. 

r - T --—--1 

|Operation|Operand | One POSTSEND macro instruction is 

[ -j-- j required in each LPS* and it must be the 

|PCSTRCV j j last instruction in the Send group. No 

i- ± ---J operand is required. 


4 



72 DCS CTAM Message Control Pregram 











r--- T - 

(Operation|operand 

h- + - 

jPCSTSEt \L j 

L_L_ 


1 

I 

I 

J 


Receive Header (RCVHER) Macro Instruction 


The RCVHDR macro instruction identifies 
the beginning of the Receive Header 
subgroup, which contains instructions 
concerned only with the header portions of 
incoming messages, The instructions 
generated by the expansion of this macro 
instruction test whether the message 
segment being operated <pn contains the 
message header cr text cnly. If the 
segment contains text only, the functional 
macro instructions in the Receive Header 
snbgrcup are bypassed; if the segment 
contains the message header, the 
instructions in the Receive Header 
subgroup are executed. 

If the Receive Header subgroup is 
included in the IPS, it must begin with 
the RCVHDR macro instruction. fcc operand 
is required. 

r- T - 1 

|Operation|Operand | 

Y -—+- 1 

|RCVHER | | 

l-JL- J 


Receive Segment (BCVSEG) Macro Instruction 


Ihe RCVSEG macro instruction identifies 
the beginning of the Receive Segment 
subgroup, which contains instructions 
ccncerned with bcth header and text 
portions of incoming messages. 

If the Receive Segment subgroup is 
included in the IPS, it must begin with 
the RCVSEG macro instruction. No operand 
is required. 

r - T - T 

|Operation|Operand | 

I---^ 

|RCVSEG | j 

l-JL-J 


Send Header (SENEEEB) Macro Instruction 


Ihe SENDHDR macro instruction 
identifies the beginning of the Send 
Header subgroup, which contains 


instructions that process only header 
portions of outgoing messages. The code 
generated by the expansion of this macro 
instruction includes instructions that 
test whether the message segment being 
operated on contains the message header or 
text only. The functional macro 
instructions in the Send Header subgroup 
are executed if the segment contains the 
message header; they are bypassed if the 
segment contains text only. 

For messages being sent to a Western 
Union Plan 115A terminal# the user should 
insert an EOA character (X'HO" before a 
TRANS macro instruction or X‘ , 04 < ' after a 
TRANS macro instruction) in the first data 
byte of the header (the thirty-second byte 
of the buffer) in the Send Header 
subgroup,. 

If the Send Header subgroup is included 
in the IPS, it must begin with the SENDHDR 
macro instruction. No operand is 
required. 

r - r - T 

|Operation|Operand | 

Y -+-^ 

j SENDHDR j j 


Send Segment (SENDSEG) Macro Instruction 


The SENDSEG macro instruction 
identifies the beginning of the Send 
Segment subgroup, which contains 
instructions concerned with both header 
and text portions of outgoing messages. 

If the Send Segment subgroup is 
included in the LPS, it must begin with 
the SENDSEG macro instruction. No operand 
is required. 

r- -t ---i 

|Operation|Operand | 

Y --+- 1 

j SENDSEG j | 

l _-L~—-- J 


FUNCTIONAL MACRO INSTRUCTION DESCRIPTIONS 


The following macro instructions may be 
coded in the LPS section for any nonaudio 
line. The functional macro instructions 
for audio lines are described in the 
appropriate section. 

Warning; Individual macro instructions 
in this section do not include a 
statement of their non-applicability to 
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audic lines. Audio users must refer to 
the section FUNCTIONAL MACHO 
INSTRUCTION DESCRIPTIONS (AUDIO LINES) 
for applicable iracro instructions—no 
ethers may be used. 


Most of the iracrc instructions in this 
section apply to HTTA lines,, unless 
specifically * excepted at the beginning of 
the description. Fcr macro instructions 
applicable only tc ViTTA lines, refer to 
the section FUNCTIONAL MACRO INSTRUCTION 
DESCRIPTIONS (WTTA LINES)• 


Balt Receive (BREAKCFF) Macro Instruction 


The BREAKOFF iracrc instruction is used 
to specify a maximum length fcr each 
incoming message. If the message exceeds 
the maximum length, reception of the 
message is terminated and an error flag is 
set in bit ten cf the error half-word for 
the line. This macro instruction also 
checks if the input buffer is filled with 
identical characters, if it is, the same 
action is taken as described abeve. (A 
long sequence of identical characters is 
usually an indicaticn of terminal 
malfunction.) 


This macro instruction can be used only 
in an IPS section that handles incoming 
messages from TNX, 115A, 83B3, cr 2260 
Remote terminals, since the required BREAK 
command is not ^alid for the ether 
terminals supported. 


Use cf BREAKCFF is optional. If \3sed, 
it must appear within the Receive Segment 
ceding subgroup. 


r - y ---1 

| Operation|Operand | 

I-- + -^ 

|BREAKCFF jnnnnn j 

t-JL- J 


nnnnn 

Is the maximum number of characters 
fcr each message. The maximum value 
of nnnnn is 32767; leading zeros are 
net required. 

Note : Execution of the BREAK command on 

the 2260 Remote terminal does net delete 
the START MI frem the screen. Thus the 
next polling of the terminal will cause 
re-reading of the same message. If this 
is not desired, a message should bo sent 
to the terminal tc clear the START MI. 


Cancel Message (CANCELM) Macro Instruction 


CANCELM is an error-handling macro 
instruction that causes immediate 
cancellation of a message if any of the 
errors specified by the mask have been 
detected. Cancellation means that the 
message is not sent to the destination(s) 
specified: 

1. In the message header (handled by the 
ROUTE macro )„ or 

2. By the DIRECT macro. 

If CANCELM is used to test for an 
invalid destination code and the error has 
occurred, the message is canceled for any 
destinations that follow the invalid one 
in the message header as well as for the 
invalid destination. 

If a message is not sent to its 
intended destination due to cancellation,,, 
it is important that some action be taken 
to notify a terminal operator or to 
perform some other corrective action. If 
no action is taken, there is no record of 
which messages have been lost because of 
cancellation. The ERRMSG macro 
instruction can be used to send a message 
to a terminal notifying its operator of 
the error; or the REROUTE macro 
instruction can be used to send the 
message in error to a selected terminal 
(see the descriptions of these macros). 
CANCELM must precede an ERRMSG or REROUTE 
macro instruction used to test for the 
same error condition in the End Receive 
subgroup. 

The meaning of the bits in the error 
halfword tested is shown in Figure 15. 

Use of CANCELM is optional. If used, 
it must appear within the End Receive 
subgroup of the LPS. Because all error 
types requiring message cancellation can 
be specified in the same error mask„ only 
one CANCELM macro instruction is needed in 
the End Receive subgroup. 

The CANCELM macro instruction must not 
be used in an LPS handling either messages 
to a PROCESS-EXPEDITE queue or 
multisegment messages in Initiate mode, 
since cancelled messages must be recalled 
from the DASD destination queue. 

r- -t--- 

|Operation|Operand 

Y -+-- 

jCANCELM jmask 

l_X_*--—-- 

mask 

Is the hexadecimal representation of 
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the bit configuration used to test 
the error halfword for the 
communication line involved. Ihe 
frairing X and quotes must be coded. 


COUNTER Macro Instruction 


The COUNTER iracrc instruction enables 
the user to maintain four types of count: 

1. Incoming message segments for each 
originating terminal, or incoming 
message blocks if ECE characters are 
received from IEM terminals and the 
ECE or ECEIC macro is used 

2. Incoming complete messages for each 
originating terminal 

3. Outgoing message segments for each 
destination terminal 

4. Outgoing complete messages for each 
destination terminal or terminal 
component that has a single-terminal 
entry in the terminal table 

The position of the COUNTER macro 
instruction within the IPS determines 
which of the four types of count will be 
maintained. COUNTER must appear in the 
Receive Segment subgroup to count incoming 
message segments cr blocks, in the Receive 
Header subgroup to count incoming 
messages, in the Send Segment subgroup to 
count outgoing message segments, and in 
the Send Header subgroup to count outgoing 
messages. Any cne, cr all four counts, 
can be maintained by including the COUNTER 
macro instruction in the appropriate 
subgroups; within each subgroup, it may 
appear at any point. 

For each COUNTER macro instruction 
issued, the user must define, by means of 
one CETICN macro instruction, a two-byte 
field (aligned on a halfword boundary) for 
each entry in the terminal table for which 
a count is to be maintained. This 
provides space for maintaining the 
messages per terminal or message segments 
per terminal count. The number of COUNTER 
macro instructions used in the IPS and the 
number of OPTION macro instructions for 
the count fields must each correspond to 
the number of counts being maintained. 

See the OPTION macro instruction 
description. 

Use of COUNTER is optional. COUNTER 
must not be used in the Receive Segment 
subgroup for switched lines or for lines 
using Auto Poll, When used in the Receive 
Header subgroup, it must be preceded by a 
SOURCE macro instruction. 


Note : If COUNTER is used to record 

incoming messages from a line group to 
which IBM 2260s are attached,, each time a 
general poll is performed all message 
segments received from the various 2260s 
during that polling pass are counted as 
one message. 


f - T -1 

|Operation|Operand | 

K-+-1 

I COUNTER |subfield j 

L _X_J 

subfield 

Is the name of a halfword field in 
the user°s area of each 
single-terminal entry in the terminal 
table, as defined by an OPTION macro 
instruction. The field contains a 
binary count up to a maximum of 
32,767. When maximum count has been 
reached,, the count is reset to 1 for 
the next message or segment counted. 
The user may access the field at any 
time to determine and/or reset the 
count. 


Date Stamp (DATESTMP) Macro Instruction 


The DATESTMP macro instruction causes 
insertion of the date in the message 
header. DATESTMP can be included for 
incoming messages,, outgoing messages,, or 
both. The date is expressed as either 
bmm/dd/yy or bdd/mm/yy, where b is a 
blank,, dd is the day of the month*, mm is 
the month,, and yy is the year. The format 
to be used is specified when the system is 
generated,. 

No operand is necessary in this macro 
instruction because the date field has a 
fixed length of nine. When DATESTMP is 
specified,, the user must include the 
length of the inserted field (nine bytes) 
in his calculation of the value of the 
operand of the LPSTART macro instruction 
(see the LPSTART macro instruction 
description). The DATESTMP macro 
instruction causes the contents of the 
message header to be moved nine characters 
to the left, thus moving the idle 
characters out of the header. The date is 
then inserted in the header (see Figure 
13). 

Use of DATESTMP is optional. If used, 
it must appear in the Receive Header or 
Send Header subgroup. Its position within 
the subgroup must correspond to the 
relative position*, within the header, of 
the field into which the date is inserted. 
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f - T - T 

| Operation|Operand | 

i*-+—--—-^ 

|DATESTMF I | 

1-6.-JL_ J 


Notes Ihe date inserted into the header 
will te only as accurate as the date 
entered into the system by the DATE job 
control statement or the operator SET 
command. 


DIRECT Macro Instruction 


name of the subfield specified by 
this operand must be the same as the 
name assigned to the subfield by an 
OPTION macro instruction. The 
contents of the subfield are 
specified by the TERM macro 
instruction that defines the terminal 
table entry for the originating 
terminal (see the OPTION and TERM 
macro instruction descriptions). If 
the originating terminal is on a 
switched line or on a line using Auto 
Poll* and the user wishes to use this 
operand, DIRECT must be preceded by 
the SOURCE macro instruction. 


The DIRECT macro instruction causes a 
message to be queued for the destination 
specified by the operand. Any destination 
for which there is an entry in the 
terminal table may te specified. DIRECT 
may be used in place of ROUTE when message 
headers do not contain destination cedes. 
Either DIRECT or RCUTE must be specified 
to handle message routing; both cannot be 
used. Only one DIRECT macro may be used 
for each IPS or fer each message type used 
within cne IPS. 

DIRECT may be used only within the 
Receive Header subgroup. If DIRECT is 
used, ECA may not also be used. 

Note : If the TERM macro instruction 

specifies that the IEM 2260-2848 complex 
(Remote) is to te polled using the general 
poll feature, the DIRECT macro instruction 
must be used tc send incoming messages to 
a message processing program. The 
processing program must then analyze the 
message, which consists of segments from 
different 2260s, and place each segment 
(via a PUT macro instruction) on the 
proper DASD destination queue or DASD 
process queue. 

--■-irr-rr- —r-^^^ w ^^- Tn ^-~ ff - TmTr --- nTT - T - rT .- r - r in m-rrr 

% T 

|Operation|Operand 


j DIRECT |J=CLn•dest f \ 

I j\sutfield / 

l_ JL _ 

dest 

Is the destination code, which may be 
the name of any entry in the terminal 
table, n must te equal tc or greater 
than the longest such name appearing 
in the terminal table; cr n may be 8 
(the maximum allowable length). 

subfield 

Is the name of an optional subfield 
in the terminal table entry for the 
originating terminal; this subfield 
contains the name of the terminal tc 
which the message is to be sent. The 


End-of-Address (EOA) Macro Instruction 


The EOA macro instruction is required 
if the user wishes to provide multiple 
routing of incoming messages. The 
instructions generated by this macro 
instruction determine the end of the list 
of destination codes in the message 
header. The character sequence specified 
by the EOA macro instruction must appear 
in the header of each message after the 
last destination code, regardless of the 
number of destination codes in the header. 

When used*, this macro instruction must 
immediately follow the ROUTE macro 
instruction. EOA is not used if DIRECT is 
specified. 

The EOA macro instruction must not be 
used in an LPS handling messages to a 
PROCESS-EXPEDITE queue. 

r- r - 

|Operation|Operand | 

i--+--t 

|EOA |eoa | 

1 I I 

l_JL_J 

I 

*| eoa 

j Is the EOA character or sequence of 

| characters that must appear in the 

J message header after the last 

destination code. If the destination 
codes all have the same length,, and 
the optional operand in the ROUTE 
macro instruction is specified„ no 
blank is required between the last 
code and the EOA character sequence. 
Otherwise, a blank must separate the 
two. One to eight nonblank 
characters may be specified as the 
EOA sequence. The EOA character(s) 
may be specified either as the 
character itself,, or as the 
hexadecimal equivalent of the 
character(s). The framing C or X and 
quotes must be coded. 


76 DCS QTAN Message Control Program 












Examples ; In an ECA iracro instruction 
that specifies a # tc be used as an ECA 
character, the M may he written: 

1. As the character itself, cr 

2. In hexadecimal representation of the 
EECDIC equivalent of that character: 


r - T - T 

| Operation|Operand | 

h- + - 1 

| ECA |C*# f | (1) 

| EGA |X*7B f j (2) 

L-_-_X_„_J 


End-of-Block CECB) Macro Instruction 


This macro instruction is not 
applicable to WTTA lines or tc the IBM 
2260-2848 Local, A longitudinal 
redundancy check (LBC) is performed each 
tiire an end-cf-blcck (ECE) or end-of-text 
(ETX) character is encountered in message 
text. The check is made by the data 
adapter at the central processing 
location, for incoming messages, and by 
the terminal ccntrcl unit, for outgoing 
messages. The ECE causes a positive 
response to be sent to the source of the 
message, if the data was received 
correctly. 

Ecr Incoming Message s: The ECB macro 
causes a positive response to be sent tc 
the terminal if the message data was 
correctly received; this permits the 
terminal to send ancther message block. 

If the data was inccrrectly received, no 
response is sent; the computer immediately 
ends message transmission by sending an 
end-of-transmissicn character. The 
terminal must resend the message block 
when contact with the computer is 
reestablished (by polling cr dialing). 

For Outgoing message s: The ECB macro 
causes an ECE (cr ETX), followed by an IRC 
character, tc be sent to the terminal when 
an ECE (or ETX) character is encountered 
in message text. If the terminal receives 
the message data correctly, it returns a 
positive response; upon recognizing this 
response, the computer sends the next 
message block. If the terminal receives 
the data in error, it returns a negative 
response; upon receiving this response, 
the computer ends the message transmission 
by sending an end-cf-transmissicn 
character. 

The ECB macro instruction must normally 
be specified, in both the End Receive and 
End Send subgroups cf each IPS that 
handles messages tc and from an IBM 1030, 


1050, 1060, 2260 Remote, and 2740„ Types 
274D, 274E, 274F, and 274G. The EOB macro 
must be specified for a 2260-2848 Remote 
for which general polls are to be 
performed. It may be omitted only 
if: (1) all messages are one block long, 

and (2) possible errors are to-be ignored 
(both conditions are required). If the 
ECB macro is not specified, the first EOB 
(or ETX) character encountered in incoming 
or outgoing message text is treated as an 
end-of-transmission (EOT) character, 
precluding transmission of any subsequent 
blocks of that message. 

Either the EOB or the EOBLC macro 
instruction must be specified in both the 
End Receive and the End Send subgroups of 
the LPS that handles messages for the IBM 
2740 Model 2 terminals. 

This macro instruction is used only for 
the terminal types cited. In the case of 
the IBM 1050, 2260 Rempte.,, 2740,, Types 
274D, 274E, 274F f , and 274G, and 2740 Model 
2, the EOBLC macro instruction (discussed 
in the following section) may be specified 
instead of the EOB macro. 

Upon the occurrence of an error or 
condition for which the user has specified 
a CANCELM*, ERRMSG* or REROUTE macro 
instruction, message transmission ends 
when the next EOB (or ETX) character is 
detected, if the error-handling macro 
instruction precedes the EOE macro. 

Note : Error-handling macro instructions 

should not precede the ECB macro 
instruction because, if the specified 
error condition occurs, the EOB macro 
instruction will not be executed. The EOB 
character will be treated as an EOT,, and 
the source terminal will not receive a 
response to the EOB-LRC sequence. 

Within the coding subgroup in which the 
EOB macro appears,, all functional macro 
instructions that precede the EOB macro 
are executed for all message blocks; all 
functional macros that follow the EOB 
macro are executed only at the end of the 
message (an EOB is treated as an end of 
message if a transmission error occurred 
during transmission of the block). The 
EOB macro instruction must not be used in 
an LPS handling messages to a 
PROCESS-EXPEDITE queue. 

r- t-1 

|Operation)Operand | 

H-+- 1 - H 

| EOB | | 

l_X-'___J 


End-of-Block and Line Correction (EOBLC) 
Macro Instruction 
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This macro instruction is not 
applicable to fcTTA lines. ECE1C is an 
optional iracrc instruction used only for 
an IBM 1050, an IEM 2260-2848 Remote 
equipped with the checking feature, and 
IBM 2740, Types 274D, 274E, 274F, and 
274G, and an IEM 2740 Model 2. It 
performs the same function and is used in 
the same manner as the EOB iracrc, but in 
addition returns a negative response to 
the message scurce if the data was 
incorrectly received, permitting the 
scurce tc resend the erroneous message 
block. 

Either the ECE cr the EOBLC macro 
instruction must be specified in both the 
End Receive and the End Send subgroups of 
the LFS that handles messages fcr the IBM 
2740 Model 2 terminals. 

For a 2260-2848 local line groups this 
macro instruction is used only in the Send 
group cf the IPS. If a data parity error 
is detected while sending a message to a 
2260 (or 1053 Printer), ECEIC causes the 
message tc be resent in an attempt tc 
correct the error condition. 

For Incoming Mes s ages : 

1. For an IEM 1050 not equipped with the 
line correction feature, resending is 
accomplished hy rekeying the message 
block in error, or by repositioning 
the paper tape cr card containing the 
erroneous blcck. 

2. Fcr an IEM 2260 Remote, the terminal 
automatically resends the message 
Hock. 

3. For an IEM 2740, resending is 
accomplished by rekeying the message 
block in errcr. 

4. Fcr an IEM 1050 equipped with the 
line correction feature: 

a. If the erroneous message blcck 
originated from the paper tape 
reader cr card reader, the device 
automatically repositions the 
tape or card and resends the 
block. 

b. If the erroneous message block 
originated from the keyboard, the 
operator must re-enter the 
message blcck in errcr. 

For Outgoing Messages : For either of the 
above terminal types, the computer 
automatically resends the erroneous 
message block. 

If ECEIC is specified, any message 
block whose transmission resulted in an 


error is retransmitted a maximum of two 
times. If the error persists after the 
second retry,, an error flag is set in the 
error halfword for the line (see Figure 
16). 

The EOBLC macro instruction must not be 
used in an IPS handling either messages to 
a PROCESS-EXPEDITE queue or multisegment 
messages in Initiate mode. 

r--- t- 1 

|Operation)Operand | 

|EOBLC | | 
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Error. Message (ERRMSG), Macro Instruction 

The ERRMSG macro instruction causes a 
user-written error message to be sent to a 
designated terminal when one of the errors 
specified by the error mask has occurred. 

By means of the ERRMSG macro,, the user 
specifies: 

1. The bit configuration of the mask 
used to test the error halfword. The 
meaning of the bits in the error 
halfword tested is shown in Figure 
15. 

2. The destination to which the error 
message is to be sent. 

3. The text that is to comprise the 
error message. 

The error message includes the text 
written by the user and, optionally* the 
header of the message in error. The user 
specifies that the header is to precede 
the text by writing a period as the first 
character of the text. The length of the 
complete error message cannot exceed one 
segment (that is* one buffer). 

If the ERRMSG macro does not specify 
that the message header is to be included 
with the error text, no LPS macros that 
refer to fields in the header may be used 
in the Send Header subgroup that is to 
process the error message* without some 
modification by the user. 

It is assumed that for an ERRMSG macro 
that does not specify inclusion of the 
header of the message in error* the user 
will place the machine EOA character or 
sequence in the first character 
position(s) of the error text. (However, 
inclusion of the machine EOA character is 
not necessary for error messages to be 
transmitted to an IBM 1050* IBM 2740* IBM 
2260 Remote, or IBM 2260 Local.) This is 
required by the terminal to receive the 
error message regardless of which LPS 
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macros are to process the error message. 
The scan pointer register, register 5, 
will he pointing tc the first character 
ofthe error message? this character will 
be the ECA character (or the first 
character of the ECA sequence). If the 
user chcoses to have a DATESTMP, TIMESTMP, 
or SEQCUT macro operate on an error 
message that does net contain the header 
of the erroneous message, he must reset 
the scan pointer register to point tc the 
first character following the machine ECA. 
This may he dene hy incrementing the 
register by the number of characters 
comprising the ECA sequence. 


Unless the MSGTYEE macro instruction is 
used tc distinguish between different 
message types, the format of the header 
for an error message must be identical to 
the header format used for other outgoing 
messages. If the MSCTYPE macro 
instruction is used for this purpose, the 
formats of the respective message headers 
for the two types may differ after the 
message-type character. In either case, 
the correct machine ECA character for the 
destination terminal must be included. 


If the incoming sequence number is 
invalid, and an errer message is to be 
sent, ERRMSG will scan the error message. 
If the special character $ is encountered, 
the correct input sequence number is moved 
intc the four bytes following the $,„ and 
the $ is overlaid with a blank. If a 
seccnd $ is feund before the end of the 
errer message, the invalid sequence number 
is moved intc the four bytes following the 
$, and this seccnd $ is also overlaid with 
a blank. If this function is net desired,, 
the special character $ should not appear 
in the error message text. 


If the message is to be cancelled, the 
CANCEIM macro instruction must be used 
befere the ERRMSG macro instruction* 


r- t- 

|Operation|Operand | 
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mask 

Is the hexadecimal representation of 
the bit configuration used to test 
the error halfword. 

dest 

Is the destination code for the 
terminal to which the error message 
is sent? it may be the name of any 
entry in the terminal table except a 
distribution list entry, n must be 
equal to or greater than the longest 
such name appearing in the terminal 
table. The maximum value for n is 8. 

subfield 

Is the name of a terminal table 
optional subfield that is associated 
with the name of the terminal from 
which the message in error 
originated. The error message is 
sent to the destination whose name 
appears in the optional subfield. 

SOURCE 

Specifies that the error message is 
to be sent to the terminal from which 
the message in error originated. 
SOURCE may not be used if this ERRMSG 
macro is used for an illegal source 
code error (that is, if the mask 
contains a 1 in bit 6) originating 
from a switched terminal. SOURCE 
must not be used for lines using Auto 
Poll if the Receive Header subgroup 
does not contain the SOURCE macro 
instruction. 


This macro instruction, if used, must 
appear within the End Receive and/or End 
Send subgroup of the IPS? it can appear 
more than once in either subgroup. 


Restriction : ERRMSG must not be used to 
send an error message on a message sent to 
a message processing program identified by 
a PROCESS macro instruction with the 
EXPEDITE operand. 


Rote : Messages generated by the ERRMSG 
macro may not be retrieved. 


message 

Is the actual text of the error 
message. 

msgehar 

Is the address of the first character 
of the error message text. This 
address must not be defined by an EQU 
statement. 

Example : Shown below is an ERRMSG macro 

instruction used within the End Receive 
subgroup of an IPS to test for invalid 
destination codes or erroneous sequence 
numbers. The first operand is the 
hexadecimal representation of the bit 
configuration (1011000000000000) of the 
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mask that tests bits 0, 2, and 3 of the 
error halfword- The second operand 
indicates that the error message is to be 
sent to the terminal from which the 
message in error originated. The third 
operand is the address of the first 
character of the errcr message text. 

r -*- T ->- n 

|Operation|Operand | 

h-4- i 

JERRNSG jX*E000 f ,SOURCE,ERMSGC23 j 

L- X _J 

Example : Shown below is an ERRRSG macro 

instruction used within the End Send 
subgroup of an LFS tc test for 
transmission errors in outgoing messages 
tc an IER 2740 with station control. The 
first operand is the hexadecimal 
representation of the bit configuration 
(0000000010000000) cf the mask that tests 
hit 8 of the errcr halfword. The second 
operand is the name cf the terminal tc 
which the error message is to be sent (all 
errcr messages are sent to the same 
terminal regardless cf which destination 
terminals were tc have received the 
message in error). The third operand is 
the text of the errcr message. The period 
as the first character causes the header 
of the message in errcr tc precede the 
error text. If the error message is sent 
to an IER terminal, it should* as any 
message should, end with an end-of-block 
character. 


f - r -1 

| Operation|Operand | 

t-4-1 

|ERRMSG | X* 0080 V, =CL8 * N'XCSUFVR * , | 

| |=C , .TRANSK ERROR* | 
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Intercept (INTERCFT) Macro Instruction 


The INTERCFT macro instruction is used 
to permit messages that could net be 


transmitted to a terminal to be sent at a 
later time. It causes the suppression of 
all message transmission to a terminal 
when any of the errors specified by the 
mask has been detected. The untransmitted 
messages remain on the DASD destination 
queue for that terminal. If the INTERCPT 
macro instruction is to be used w the user 
must specify a 3-byte subfield in the 
optional user area of the terminal table? 
the name of this subfield must be 
specified by the INTRCPT operand of the 
LPSTART macro instruction (see the OPTION 
and LPSTART macro instruction 
descriptions). For each terminal for 
which message transmission is suppressed: 


1. The relative disk address of the 

first intercepted message header is 
placed in the subfield reserved in 
the entry representing that terminal 
(allows rerouting and later 
transmissions). 


2. The intercept bit in the IJLQTSTA 
byte of that entry is set to 1. 

3. The send bit in the IJLQTSTA byte for 
that entry is set to 0. 

No further messages are sent to the 
affected terminal until the user resets 
the intercept and send bits. This can be 
done by a message processing program using 
the RELEASED or CHNGT macro instruction. 

If RELEASEM is used, all suppressed 
messages (those on the destination queue) 
and any new messages are sent. If CHNGT 
is used, only the new messages (those 
placed on the destination queue after 
CHNGT has been issued) are sent. In the 
latter case, the suppressed messages 
remain on the destination queue,, and 
cannot be sent unless the user obtains 
them by a RETRIEVE macro instruction and 
reissues a PUT for each of them. 

The meanings of the bits in the error 
halfword tested are shown in Figure 15. 
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Bit Functio n and Explanation 

0 Invalid destination code . The ROUTE macro instruction found a destination code 
in the message header for which there is no corresponding destination name in 
the terminal table. The message for the invalid destination is placed on the 
dead-letter queue. If a CANCELS macro instruction is given for this error 
condition, the Message is canceled for any destinations whose codes follow the 
invalid cne in the message header as well as for the invalid destination. 

1 Terminal inoperative . The message was not sent to its destination because the 

send hit (hit 6 of the IdLQTSTA field) in the terminal table entry for that 

destination is off (i.e., a zero bit). 

2 Sequence number high . The SEQIN routine found a message sequence number higher 
than the expected number for the next message originating from that terminal. 
When this error is detected*, the expected sequence number is not changed. 

3 Sequence number low . The SEQIN routine found a message sequence number lower 

than the expected number for the next message originating from that terminal. 

If the message is not canceled by the user, the same sequence number may appear 
in more than one message. When this error is detected,,, the expected sequence 
number is net changed. 

4 Incorrect-length message. 

1. An incorrect-length message has been received from an IBM 2260 Local 
terminal. This occurs when the terminal operator enters a message without 
having pressed the START key, or presses the ENTER key immediately after 
pressing the START key; that is, no text is entered. 

2. It also indicates a buffer overflew condition detected on the 2740 Model 2 
or 2848. 

5 Incomplete header . The incoming message header did not terminate within the 
first message segment (cr prior to the first end-of-block character). 

6 Invalid source code . The SOURCE routine found that the source field in the 
incoming message header contained a code that: 

1. did not correspond to the name of the terminal that was connected to the 
computer ever a ncnswitched line, or 

2. did net correspond to any terminal name in the terminal table (applicable 
only to switched terminals). 

7 should-not-occur error . Error Recovery Procedures have found an error which 
should not occur. 

8 Transmission error . An error in transmission (unit check or channel error (CSW 
bits 43-473) occurred during the receiving or sending of a message (see also bit 
12). In case of unit check* the field in the LCB labeled IJLQLSEN contains the 
sense information received from the device in error* 

9 Timeout exceeded . The maximum allowable time interval between reception of 
successive characters of a message, cr between polling/addressing of a terminal 
or component and receipt of a response from the terminal has been exceeded, 
indicating possible terminal or line failure (see also bit 12). Set from sense 
bits = timeout and/or intervention required. 

10 Breakoff error . The EREAKOFF routine found an incoming message whose length 

exceeded the maximum allowable length, or one in which all of the characters in 
one of the buffers containing the message were identical (indicating line 
trouble). 


Figure 15. Communication Line Error Halfword (Part 1 of 2) 


Message Control Program 81 







j 11 Insufficient buffers . The QTAM buffer assignment routine was unable to j 
| provide buffers for an incoming message. This condition* when it occurs j 
j infrequently* may be corrected by requesting the originating terminal to j 
j resend the message. Frequent occurrences of this condition require that QTAM j 
j be redefined with a larger number cf buffers. j 

j 12 Messag e not sent . The message was not sent because of a unit check or channelj 
| status error* a timeout* or a negative response. The specific reason is j 
| indicated by the presence cf a 1 in bit 8 or 9 in combination with the 1 in j 
| bit 12: | 

j 1. A 1 in both the 8 bit and 12 bit indicates that a transmission error j 
j prevented message transfer. | 

j 2. A 1 in both the 9 bit and 12 bit indicates that the maximum allowable timej 
j interval between polling or addressing of a terminal and receipt of a j 
j response from that terminal has been exceeded. This indicates possible j 
| terminal or line failure. j 

j 3. A 1 in only the 12 bit indicates that a negative response to addressing j 
| has teen received. j 

j 13 Control Unit Failure . A control unit failure occurred during the initial | 
j selection of a channel pregram. It is also set if an error recovery CCW j 
| initiated by EPF does not properly complete. It is intended for statistical j 
j use only and remains set for the users inspection even though subsequent | 
j retries cf the operation may result in successful transmission. j 

| 14* 15 For internal use by QTAM. j 


Figure 15. Communication Line Error Halfword (Part 2 of 2) 


After the first message has keen 
intercepted for any condition specified, 
the send bit in the terminal table entry 
for the terminal is turned off. This 
causes all subsequent messages for that 
destination not to be sent, and setting of 
the terminal inoperative bit (bit 1) in the 
error halfword. These subsequent messages 
will net be intercepted unless the error 
mask to test the error halfword has the 
terminal inoperative kit specified. 

It is recommended that the user include 
an INTEBCPT macro in his LPS for IBM 
terminals on a switched network and in his 
LPS fer TWX terminals to intercept messages 
for which an addressing error (bit 12) 
occurs. The addressing error occurs 
whenever QTAM attempts to dial a terminal 
and the call is net completed. If INTEBCPT 
is not included and the addressing error 
occurs* QTAM flags the current message as 
though it had been transmitted. 

Similarly, use cf INTEBCPT is 
recommended to handle possible addressing 
errors when messages are being sent from 
the CPU to a 1053 Printer attached to the 
2260-2848 Display Complex (Remote). A 
negative response to addressing (bit 12) 
occurs when the printer is addressed and a 


previous message sent to the printer by 
either the CPU or a 2260 Display Station 
has not been completely printed. 

Use of INTERCPT is optional. However* 
if it is not used, messages that could not 
be transmitted are considered as 
transmitted by QTAM* even though they did 
not reach their destination. If used, it 
must appear in the End Send subgroup of the 
LPS. 

|Operation| Operand | 

|INTERCPT | mask,subfield | 

L_J.-J 

mask 

Is the hexadecimal representation of 
the bit configuration used to test the 
error halfword for the communication 
line involved. 

subfield 

Is the name of an optional subfield in 
the terminal table entry for the 
terminal that has messages to be 
intercepted. If the error condition 
being tested has occurred* the 
relative disk address of the first 
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suppressed message is placed into this 
sufcfield. 


legging (ICGSEG) Macro Instruction 


The ICGSEG macro instruction enables the 
user tc log message segments (place them on 
an output device as a record cf message 
traffic carried by the line group). The 
user nay maintain any or all cf four types 
cf logs by appropriate placement of ICGSEG 
within the IPS. The four types of logs,, 
and the corresponding coding subgroup in 
which ICGSEG must appear,, are: 


1. Incoming headers only (Receive Header) 


2. Ml incoming segments, or incoming 
message blocks if ECE characters are 
received frem IEM terminals and the 
ECE or ECBIC macro is used (Receive 
Segment) 


3. Cutgoing headers only (Send Header) 

4. Ml outgoing segments (Send Segment) 

If all segments cf messages are logged, 
they are logged in the sequence in which 
they are received or sent. Therefore, 
segments cf different messages are 
intermixed on the log, not grouped together 
as individual messages. If the PREFIX 
operand is specified, the last 24 bytes cf 
a QTAM header prefix are recorded on the 
logging device. These bytes precede the 
header portion (and text portion, if any) 
of the first segment cf a message. The 
last 14 bytes cf a QTAM text prefix are 
recorded on the legging device. These 
bytes precede the text portion cf a text 
message segment. In all cases, the prefix 
is expressed in ncnprintable 
representation. 

IOGSEG may appear at any point in the 
subgroup in which it is used. However, the 
results of any alteration of segments by 
functicnal macrc instructions preceding 
ICGSEG will appear in the logged segment. 
For example, if ICGSEG is preceded by 
TIMESIMF, all logged headers will contain 
time-cf-day information; if TIMESTMP 
follows ICGSEG, headers will be logged 
without time-cf-day information. 

The legging effected by ICGSEG is in 
addition tc the legging associated with the 
queueing procedure of QTAM. Use of ICGSEG 
is optional. 


| Operation) 

Operand 

1 

. .J 

|IOGSEG j 

l -X. 

filename[„PREFIX] 
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filename 

Is the name of the DTF table the user 
must define to specify the parameters 
of the file used for logging the 
message segments.. The DTP xx macro 
instruction for the file on which the 
messages are logged must specify 
WORKAREA=YES„ 

The DTF table address may be loaded 
into parameter register 1 prior to 
execution of this macro instruction; 
filename may then be coded as (1). 

PREFIX 

Specifies that the QTAM header or text 
prefix is to be included with the 
logged segment. If this operand is 
not coded,, the prefix is not logged. 
The first 8 bytes of the prefix are 
not included. Thus a header segment 
is logged with a 24-byte prefix and a 
text segment is logged with a 14-byte 
prefix. The format of the QTAM 
prefixes is contained in Appendix 


Message Mode (MODE). Macro, Instruction 

The MODE macro instruction causes 
execution of a designated function, either: 

1. Unconditionally (the designated 
function is performed for all messages 
handled by this portion of the LPS)„ 
or 

2. Conditionally, if the next nonblank 
character of the message header is the 
same as a character designated by the 
MODE macro instruction. 

In the second case,, if the characters are 
not the same, control returns to the next 
instruction in the LPS, and the scan 
pointer is reset to its position before the 
comparison. 

MODE can cause the execution of any of 
four IBM-provided functions. The functions 
provided by IBM are discussed in the 
operand descriptions below. 

The message priority scheme implemented 
by the MODE macro instruction with the 
PRIORITY operand is designed to permit a 
message from one of a group of lines 
sending to a common destination to be sent 
ahead of the other messages in the queue 
for that destination. The priority routine 
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compares the relative priority indicators 
of the last message sent from each line 
originating messages for the common 
destination. The highest-priority message 
is sent first, followed by the ether 
messages, in order according to their 
priorities. The priority conferred on a 
message is valid cnly if that message is 
the last message tc he sent from that line 
that is in the destination queue. If more 
than cne message from a line is currently 
on the same destination queue, cnly the 
message last placed on that queue can have 
valid priority. 

Example ; Assume that lines A, E, and C are 
all sending messages to line E. 


Originating 

Line 

Arrival of 
Incoming Messages 



->Time —> 

A 

© 

© © 

B 


© © 

C 


© © 


Messages being sent with priority are 
circled* (priority is indicated by 
superscript, 3 is highest priority). For 
the purpose of this example, a heavy circle 
indicates that the message was actually 
sent with priority; a dotted circle 
indicates that the message lost its 
assigned priority. This is explained as 
fellows: 

Assume that by time t, seven messages have 
arrived on the destination queue for line 
D, in the order A* E ± A 2 C± A 3 E 2 C 2 . 

Since messages A 3 , E 2 , and C 2 are the last 
messages received from their respective 
originating lines, only they will have 
priority. That is, because pricrity 
message A 3 arrived on the destination queue 
before priority message A 2 , previously 
placed on the queue, was sent, message A 2 
loses its assigned priority and is sent on 
a first-in-first-cut basis, like all other 
nonpriority messages. Assuming no more 
messages arrive cn the destination queue 
before all the messages are sent, the 
messages cn the queue are sent in the order 
c 2 b 2 a 3 a^ a 2 c a . 

Taking the example a step further, 
assume that at time t, message C 2 is sent. 
Then a new priority message, E 3 , arrives on 
the queue before message E 2 is sent; this 
causes B 2 to lose its priority status to 
E 3 . If no more messages arrive on the 
queue, the remaining messages are new sent 


in the order B 3 A 3 A a B ± A 2 C ± B 2 . 
case is not shown in the diagram. 

Since the priority of some messages may 
be lost, due to later messages arriving on 
the disk for the same terminal, it is 
advisable that if PRIORITY is specified, 
sending should have priority over receiving 
(CPRI=S in DTFQT) in order to get messages 
off the disk as quickly as possible. This 
is particularly advisable for lines 
expected to have heavy volume. 

Use of MODE is optional. If used* it 
must appear in the Receive Header or Send 
Header subgroup of the LPS, and may be used 
more than once in either subgroup. Its 
position within the subgroup must 
correspond to the point during header 
processing at which the function designated 
by its operand is to be performed* If used 
in the Receive Header subgroup of the LPS,, 
the PRIORITY* CONVERSE, INITIATE* and 
condchar operands may be specified; if used 
in Send Header subgroup, the MOD 2260 and 
WRT60 operands may be used. 


r - r - 
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j 
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PRIORITY 

Causes scanning of the header to 
locate the next nonblank character. 
This character is the priority value 
of the incoming message; it must be a 
letter or a digit. The priority 
sequence is A* .. . , 0, ,. .. 9 (9 is highest 
priority). If MODE designates a 
specific character by means of the 
second operand, scanning of the header 
for a priority character occurs only 
when the character designated in the 
second operand is found. If no 
specific character is designated* 
scanning always occurs, and all 
messages must have as the next 
nonblank character a priority 
character. This operand is effective 
only when used in the Receive group of 
the LPS. If multiple destinations are 
entered, only the first will be 
handled with priority. TTie PRIORITY 
operand may not be specified for IBM 
274 0 Model 2 terminals,. 

CONVERSE 

Causes the line on which the 
originating terminal is located to be 
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placed in conversational mcde. The 
line is held open while an entire 
iressage frcir that teririnal is sent to 
a message processing program and that 
program sends a response iressage to 
the same terminal. Curing this time, 
no incoming messages will he accepted 
from any other terminal on the line, 
and outgoing messages that have been 
queued for sending to any terminal on 
the line will net be sent. As the 
response message is sent, the line is 
taken cut cf ccnversaticnal mode. 

After the response message is sent, 
the CPU pells the terminal. 

Exception: During closedown, the terminal 

is not polled after the response message. 
The terminal operator may either: 

1. Restore the line to conversational 
mode by sending another message; 
or 

2. End transmission by entering an 
Ed character or allowing a 
timeout tc cccur. 

If the originating terminal is a 2260 
local, the entire line group is placed 
in conversational mode. If another 
2260 Local in the line group attempts 
tc enter a message, the read request 
is recognized and queued fer later 
servicing. However, the message will 
net be received from the second 2260 
until a response message has been sent 
tc the originating 2260. 

The second operand can be specified 
fer ccnditicnal use of CONVERSE. 
CONVERSE must be used only in the 
Receive Header subgroup cf the IPS. 

Note 1 : Ihe CONVERSE option cf the MODE 

macro instruction must not be used when 
routing a message tc a distribution LIST 
with more than cne PROCESS entry. 

Note 2 : If a STCPLN has been issued to the 
line, the request for conversational mode 
is ignered. 

INITIATE 

Causes segments of a message to be 
sent from a destination queue tc the 
destination as soon as they are placed 
on the queue (normally, segments are 
net sent tc the destination until the 
complete message has accumulated on 
the queue). If a message has multiple 
destination codes specified in the 
header, the INITIATE function is 
performed only for the first 
destination. Sending to the remaining 
destinations will occur only after the 
complete message has been placed on 
the destination queue. The second 


operand can be specified for 
conditional use of INITIATE. 

Restriction: The INITIATE function 

must not be used when sending a 
message to a message processing 
program. 

Warning: INITIATE enables messages 

to be handled expeditiously. 
However, its use precludes the 
ability to perform error handling 
or to cancel the message. 

MOD 2260 

Causes QTAM to modify the write 
operation for IBM 2260s (Remote or 
Local). The specific change must be 
indicated by the WRT60 keyword operand 
of this macro. MOD2260 may be 
specified only when the MODE macro is 
included in the Send Header LPS 
subgroup. 

condchar 

Is a character that, if found in the 
header before another nonblank 
character, causes execution of the 
function specified by the first 
operand. char can be any single 
nonblank character If this second 
operand is omitted, the function is 
performed unconditionally- The 
character may be specified either as 
the character itself, or as the 
hexadecimal equivalent of the 
character. The framing C or X and 
quotes must be coded* 

WRT60 

Specifies the type of modification to 
be made to the write operation for the 
2260 (Remote or Local). 

WRT60=1 causes erasure of the 2260 
screen before the header segment of 
the current message is displayed. 

WRT60=2 causes a write-with-iine- 
address address operation for the 
2260. For a 2260 Remote, the user 
must place the desired line address in 
the first data byte of each outgoing 
message and in the data byte immedi¬ 
ately following each STX character in 
the outgoing message. For the 2260 
Local, the desired line address must 
be placed only in the first data posi¬ 
tion of the header segment. Figures 
16 and 17 show the line address speci¬ 
fications for the two devices. The 
user can insert the line address by 
either: 

1. Writing assembly language instruc¬ 
tions to perform this in his LPS 
or in a message processing pro¬ 
gram ; or 
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2. Using the FAUSE iracrc instruction. 

This operand is specified only when 
the MOD2260 operand is specified. 


ASCII-8 


ine j 
inter | 

4 

Equivalent 

(Hex) 

i 

i 

Equivalent 

(Hex) 

-T 

1 ! 

50 

T 

1 

F0 

2 1 

51 

1 

FI 

3 1 

52 

1 

F2 

4 

53 

1 

F3 

5 1 

54 

1 

F4 

6 1 

55 

1 

F5 

7 1 

56 

1 

F6 

8 1 

57 

1 

F7 

9 1 

58 

1 

F8 

10 I 

59 

1 

F9 

11 1 

5A 

1 

7A 

12 1 

5E 

1 

5E 


EECDIC 


Figure 16. Line Address ASCII and EECDIC 

Equivalents for IBM 226 0 Remote 


f - T - 1 


Selected 

Line 

Number 

i 

i 

i 

Format of 
First Data 
Eyte (HEX) 

1 

T 

! 

F0 

2 

1 

FI 

3 

1 

F2 

4 

1 

F3 

5 

1 

F4 

6 

1 

F5 

7 

1 

F6 

8 

1 

F7 

9 

1 

F 8 

10 

1 

F9 

11 

1 

FA 

12 

1 

FE 





Figure 17. Line Address Specifications for 
IEM 2260 Local 


Message Type (MSGTYPE) Macro Instruction 


The MSGTYPE iracrc instruction enables 
the user to categorize incoming and 
outgoing messages into two or mere message 
types, each of which he wishes to process 
in a different manner. A MSGTYFE macro 


instruction, encountered during processing 
of a message header,, causes the next 
nonblank character or character sequence in 
the header to be compared with a character 
or character sequence specified by the 
operand of the MSGTYPE macro instruction. 

If they are identical, the instructions 
between this MSGTYPE macro and the next 
MSGTYPE macro or the next delimiter macro 
instruction are executed. If they are not 
identical, the instructions between the 
MSGTYPE macro performing the test and the 
next MSGTYPE macro or delimiter are not 
executed; the scan pointer is reset to its 
position prior to the scan. Instructions 
between a MSGTYPE macro instruction with no 
operand and the next delimiter are executed 
for messages that do not contain a 
message-type character or character 
sequence. These instructions are bypassed 
if the message was previously handled by a 
MSGTYPE macro instruction with a 
message-type character operand. If no 
operand is specified, the scan pointer is 
not advanced. 

Use of MSGTYPE is optional,, and it may 
be used any number of tiroes. MSGTYPE may 
be used only within the Receive Header and 
Send Header subgroups. 

r- T - 

|Operation|Operand 


]MSGTYPE j typechar 

I _ _I 

typechar 

Is the message-type code. It may 
consist of from one to eight nonblank 
characters. If this operand is 
omitted (that is, a blank is 
specified)„ the group of macro 
instructions that immediately follows 
this MSGTYPE macro instruction will 
process any message not handled by a 
preceding MSGTYPE macro instruction 
with a nonblank-character operand. If 
a MSGTYPE macro with a blank operand 
is used,, it must be the last of the 
series of MSGTYPE macros. The 
message-type character sequence may be 
specified either as the characters 
themselves,, or as the hexadecimal 
equivalent of the characters. The 
framing C or X and quotes must be 
coded. 

Example : The beginning of a Line Procedure 
Specification section using MSGTYPE macro 
instructions is shown in Figure 18. 


i 

i 
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Name 


Operation 


Operand 


Comments 

Reserves 16 bytes in the message header 


LFS1 


ipstart 

RCVSEG 


16 


Delimiter 


TRANS 

RCVHDR 


RCVTWX 


Macro instruction executed for all segments 
Delimiter 


SEQIN 

SOURCE 

DATESTMP 

TIMESTMP 

COUNTER 


6 

MSGIN 


Macro instructions executed for all header 
segments 


MSGTYPE 


C" A* 


— + 


Test for Type A messages 


H 


Macro instruction executed for all Type A messages 


DIRECT 


-CI8 f CHI * 


MSGTYPE 


C” E 1 


Test for Type B messages 


DIRECT 


=CL8•NYC , 


Macro instructions executed for all Type B 
messages 


MSGTYFE 


Test fcr all other message types 


DIRECT 


=CI 8 f PRCCEESQ* 


Macro instruction executed for all other message 
types 


ENDRCV 


Delimiter 


Remaining macro instructions of LPS 


Figure 18, Use cf MSGTYFE Macrc Instruction in a nonaudio LPS 


Operator Centre! (CFCTI) Macro Instruction 


The operator control macro instruction 
designates one or two remote terminals as 
operator control terminals from which 
specified control messages may te entered 
into the system. If two terminals are 
specified, both terminals must use the same 
IPS, It is reccmnended that for an 
operator control terminal, receive have 
priority ever send on the line. Otherwise, 
a large number of error messages may make 
it difficult or impossible to enter an 
operator control message at the terminal. 

CPCTI must be specified in the Receive 
Header subgroup cf the IPS for the line 
group that contains the operator control 
terminal(s). An IEM 1050, or an IBM 2740 
with station control and checking, must be 
specified for this function. Only one 
CPCTI macro instruction may be specified. 


The message must be translated to EBCDIC 
before processing by OPCTL. When the OPCTL 
macro instruction is encountered in the 
IPS, the scan pointer must be set so that 
the next nonblank character is the first 
character in the control message 
identifier. For further information refer 
to the Operator Control Facility section. 

Operator control messages are processed 
only by those macro instructions in the 
Receive group that precede the OPCTL macro 
instruction. Therefore,, if the user wishes 
to insert the date or time of day 
information into the operator control 
message, the DATESTMP and TIMESTMP macro 
instructions must precede the OPCTL macro 
instruction*. 

Responses to operator control messages 
(sent in response to the COPYC and COPYT 
messages) are sent to the requesting 
terminal. 
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Restriction : operator control terminals 
receiving response messages or messages 
from error recovering procedures must have 
end-of-block checking feature. 


Fame 

|Cperaticn|Cperand 

_L 

opname 

| OPCH 

T 

|CTIMSG=msgname, 


1 

j TERM=termname, 


1 

j [,ALTERM=termname] 


1 

| [,INTRCPT=syrrbol] 


.X ___ 

4 


opname 

The name of the macro instruction. It 
must be specified. It must be from 
one to eight nonblank characters. 

CTLMSG 

The control message identifier 
consisting of one to eight nonblank 
characters. 

TERK 

The name of the operator control 
terminal as it appears in the terminal 
table entry for this terminal. 

ALTERN. 

If specified, the name of an alternate 
operator ccntrcl terminal as it 
appears in the terminal table entry 
for that terminal. 

INTRCFT 

Is the name of a three-byte optional 
subfield in a terminal table entry and 
must be the same as the name assigned 
to the subfield by an CPTICN macro 
instruction. This subfield contains 
the relative disk address cf the first 
intercepted message header. This 
operand must he specified if the user 
wishes tc use the Intercept Control 
Message (refer tc Operator Control 
Facility section for further 
information cn the Intercept Control 
Message). If the user attempts to use 
the Intercept Control Message when 
this operand has been omitted, the 
message is treated as an error. 


PAUSE Macro Instruction 


PAUSE causes automatic transmission of a 
user-specified sequence of characters on 
the communication line each time the IPS 
section containing the PAUSE encounters a 
user-specified character in the message 
segment currently being sent. The inserted 
characters are not placed in the outgoing 
message segment as contained in main 
storage. Rather, they become part of the 
segment as received at the terminal. To 


illustrate: If a message segment 

containing the characters 

ABCDEF*GHI*ABCD*MNOPQ*RSTU**ABC 

is handled by an LPS in which a PAUSE macro 
specifies insertion of the characters XY 
each time an asterisk is encountered, the 
segment as contained in main storage 
remains unchanged, but as received by the 
destination terminal becomes 

ABCDEF*XYGHI*XYABCD*XYiyiNOPQ 

*XYRSTU*XY*XYABC 

This facility has two main uses: 

1. It permits the user to effectively 
modify outgoing message headers by 
inserting extra characters. The need 
for this arises when message headers 
received from certain terminal types 
are to be sent to other terminal 
types. In certain instances,; extra 
control characters must be sent on the 
line during transmission of the 
header, in order for the message to be 
received properly. 

2. It permits sending of nonprinting idle 
characters over the communication 
line, where necessary to prevent loss 
of message data. This usage is not 
required for the 2260-2848 Display 
Complex. 

Characters in outgoing messages are sent 
continuously, even while the terminal 
device receiving the message is performing 
a mechanical positioning operation that 
interferes with correct recording of the 
incoming characters. For example, some 
terminal printers require more time for the 
carriage return operation than is available 
between printing of successive message 
characters: characters are printed 

randomly during the carriage return 
movement,. 

To avoid partial loss of a message from 
this cause, one or more nonprinting 
characters must be inserted into the 
message after each device control character 
(such as carriage return) that performs an 
operation otherwise resulting in loss of 
message characters. These nonprinting 
characters are referred to as idle 
characters, although the specific character 
tc be used depends on the type of terminal 
that receives the message. The idle 
characters used by each type of device are 
shown in Figure 19. 

The PAUSE macro can be used to cause 
insertion of idle characters each time a 
designated device control character appears 
in the message. (Device control characters 
can be inserted by a user-^provided 
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subroutine cr by the terminal that 
originates the message.) The specific 
control characters fcr which insertion is 
required, and the number of idle characters 
required for each, vary among terminal 
device types. Fcr these requirements, see 
the reference manuals fcr the various 
terminal types. 


The PAUSE macro instruction specifies: 

1. The character that is to cause 
insertion. 

2. The number cf character sequences to 
be inserted. 

3. The transmission cede bit 
configuration of the characters to be 
inserted. 

A separate FAUSE macro instruction must 
be specified for each control character for 
which insertion is required. 

PAUSE, if used, must appear within the 
Send Header cr Send Segment subgroups. If 
the TRANS macro instruction is used,, the 
PAUSE must follow TFANS in the IPS. 

If the PAUSE is used# the irmir operand of 
the BUFFER macro instruction may not be 
omitted and must be nonzero. Otherwise, 
the PAUSE macro instruction will not be 
effective. 

Care should be taken in specifying the 
operands of the PAUSE macro instruction. 
Depending on the relative position cf the 
PAUSE and TFANS macro instructions, the 
PAUSE operands should be in EECEIC or in 
the transmission cede for the terminal. 

r- T - 1 

| Operation | Operand | 

I*--- + -1 

| PAUSE | ctlchar,insertchar | 

i--- x -j 

ctlchar 

The actual transmission code bit 
configuration cf the character for 
which insertion is required. It must 
he written in hexadecimal notation. 
This character cannot be an EOE cr 
EOT. 

insertchar 

The actual transmission code bit 
configuration cf the character (or 
characters) tc be inserted. It must 
be written in hexadecimal rotation 
with the franing nX* *, where n is the 
number of character sequences tc be 
inserted. (Fcr example, 5X , E2E4 i 
specifies that the sequence AE [in 
1050 code] is tc be sent five 


times.) This character cannot be an 
EOB or EOT. 


Example : A PAUSE macro instruction to 

cause insertion of six idle characters into 
an outgoing message to an IBM 1050 each 
time a new line (NL) character is detected 
in that message by the message control 
program (5B and 5E are hexadecimal 
equivalents of 1050 device code new line 
and idle characters, respectively): 


r-r- 

| Operation | Operand 


j PAUSE j X* 5B # „ 6X* 5E® 


*i 

i 

i 

.j 


| Terminal Type 

»■- 

jIBM 1030,1060 
jIBM 1050,2740 

I 

jwu 33, 35 
|AT&T 83B3, WU 

I 

jWTTA 

I 

I 


|Idle Character | 

- + -1 

|Idle (5E) (see note) | 
]Idle (5E) | 

jor delete (7F) j 

|Fubout (FF) j 

115A|Figures shift (IB) or j 
(letters shift (IF) j 

(Figures shift (IB) „ j 

(letters shift (IF)*, orj 
|Mark (DF) | 


Note: The IBM 1033 Printer requires the 

insertion of three idle characters prior to 
each character transmitted to it. 


Figure 19. Idle Characters 


Polling Limit (POLLIMIT) Macro Instruction 

This macro instruction is not applicable to 
WTTA lines or to the IBM 2260-2848 Local. 

POLLIMIT is an optional macro 
instruction specifying a maximum number of 
messages to be accepted from a terminal 
during one polling pass. When this limit 
is reached, the next terminal is polled. 

If no polling limit is set (the POLLIMIT 
macro instruction is not used), each 
terminal is polled until it has no more 
messages to send during that polling pass. 

The POLLIMIT macro instruction has no 
effect when used with a switched line. 
POLLIMIT may not be used for lines using 
Auto Poll if the Receive Header subgroup 
does not contain the SOURCE macro 
instruction. If used*, POLLIMIT must appear 
at some point within the Receive Header or 
End Receive subgroup. 

Note : For an IBM 2260 remote*, the LPS must 

contain a POLLIMIT macro instruction that 
specifies a polling limit of one. 
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r- T -! 

| Operation|Operand | 

I-- + -^ 

(PCILIMIT j/nnn \ j 

| |(subfield/ | 

t_ x ___J 


min 

Is the maximum number of messages the 
user wishes to allow for each terminal 
in the line group- This option may be 
used only when the number cf 
consecutive pells is to be the same 
for all terminals in the communication 
line group. The maximum value of nnn 
is 255; leading zeros are not 
required. 


subfield 

Is the name of a 1-byte optional 
subfield in a terminal table entry and 
must be the same as the name assigned 
to the subfield by an CPTICN macro 
instruction. This subfield contains 
the limit of consecutive pells to be 
allowed for the originating terminal, 
as specified by a TERMS macro 
instruction. This method cf 
specifying the polling limit allows a 
different limit to be set for each 
terminal. 


REROUTE Macro Instruction 


The REROUTE macro instruction causes a 
message to be queued for an alternate 
destination (in addition to the 
destinations specified by the message 
header) when any cf the errors specified by 
the mask have been detected. 


The meaning cf the bits in the error 
halfwerd tested is shown in Figure 15. 


If the destinations specified by the 
message header are switched terminals, the 
SOURCE macro instruction must appear in the 
LPS prior to REROUTE, in order for the 
subfield operand to be specified. A 
distribution list cannot be specified as 
the alternate destination. 


Use of REROUTE is optional. If used, it 
roust appear in the End Receive cr End Send 
subgreup. The REROUTE macro instruction 
must not be used to send messages to a 
PROCESS-EXPEDITE queue. 


|Operation|Operand | 

1 - + - 1 

|REROUTE jmask, 

] |(=CLn*dest # 

| \{subfield 

\ j(SOURCE 

L_J.- J 

mask 

Is the hexadecimal representation of 
the bit configuration used to test the 
error halfword in the line control 
block (LCB)• 

dest 

Is the destination code for the 
alternate destination. The code may 
be the name of any entry that appears 
in the terminal table. If this option 
is selected* all messages with errors 
detected by REROUTE are sent to the 
same destination, n must be equal to 
or greater than the longest such name 
appearing in the terminal table. The 
maximum value for n is 8„ 

subfield 

Is the name of an optional subfield in 
the terminal table that contains the 
name of the alternate destination. 

The name must be the same as the name 
assigned to the subfield by an OPTION 
macro instruction. If this option is 
selected, the alternate destination is 
the terminal specified in the option 
field of either: 

1. the terminal table entry for the 
originating terminal, if REROUTE is 
used in the ENDRCV section of the LPS, 
or 

2. the terminal table entry for the 
destination terminal* if REROUTE is 
used in the ENDSEND section of the 
LPS. 

SOURCE 

Specifies that the message in error is 
to be sent to the terminal from which 
it originated (in addition to the 
destination(s) specified by the 
message header). SOURCE may not be 
used for lines using Auto Poll if the 
Receive Header subgroup does not 
contain the SOURCE macro instruction, 
or if this REROUTE macro is used for 
an illegal source code (that is* if 
the mask contains a 1 in bit 6). 

SOURCE must not be used when the 
REROUTE macro instruction is in the 
End Receive subgroup if a should~not- 
occur error (bit 7), a transmission 
error (bit 8), a timeout exceeded 
error (bit 9) or a control unit 
failure (bit 13) has occurred. 
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Routing (ROUTE) Macro Instruction 


The ROUTE macro instruction causes 
scanning of the destination code field in 
the header of each incoiring message. If 
the destination code is valid, ROUTE causes 
the message to be queued for the specified 
destinations. If an invalid destination 
code (one not appearing in the terminal 
table) is detected: 

1. Eit 0 of the error halfword for the 
line containing the originating 
terminal is set to 1. 

2. The message is placed on the 
dead-letter queue. 

If further processing of messages placed on 
the dead-letter queue is required, a 
REROUTE or ERRMSG macro instruction must be 
specified in the End Receive subgroup to 
notify a terminal operator of the 
destination error. 

Messages may be routed to multiple 
destinations in any cf three ways: 

1. Mere than one destination code may be 
included in the message header. It is 
net necessary to indicate in the 
header the number of destination codes 
included. W ben this method of routing 
to multiple terminals is used, the 
user must: 

a. Include an end-of-address (ECA) 
character after the last 
destination code in the header of 
each incoming message. 

b. Specify an ECA macro instruction 
immediately following ROUTE in the 
IPS. 

2. The message header may contain a 
single destination code that 
identifies a distribution list in the 
terminal table. Each destination in 
the distribution list receives the 
message. 

3. Where special machine features are 
available, group-code transmission may 
he used. Under this method, unique 
address characters cause the sending 
cf single messages simultaneously to a 
pre-specifled group of terminals on 
the same line. 

Either the ROUTE or the DIRECT macro 
instruction roust be specified tc handle 
message routing. Ecth cannot be used for 
the same message type. Only one ROUTE 
macro may be used fer each IPS cr for each 
message type used within one IPS (see the 
MSGTYPE macro instruction description). 


ROUTE may be used only within the Receive 
Header subgroup. 

Note : If the TERM macro instruction 

specifies that an IBM 2260^*2848 complex is 
to be polled using the general poll 
feature, the DIRECT macro must be used. 
ROUTE cannot be used. 


j Operation j Operand j 

j.--f-i 

]ROUTE j Cn3 | 

l--L-J 

n 

Is the number of characters in each 
destination code in the message 
header, n is specified only if the 
user chooses to make all destination 
codes the same length. The maximum 
value of n is 8. If this operand is 
omitted,, destination codes are assumed 
to have varying lengths and a blank is 
required: 

1. After a single destination code 

2. Between multiple destination codes 

3. Between the last destination code 
and the EOA character 

If n is specified, the blanks are not 
required. 


Sequence In (SEQIN) Macro Instruction 


The SEQIN macro instruction causes 
scanning of the input sequence number field 
in the header of each incoming message. If 
the sequence number is not one higher than 
the sequence number of the last message 
received from the sending terminal, an 
error flag is set in bit 2 or bit 3 
(depending on whether the number is high or 
low) of the error halfword for the line. 
When either error condition occurs* the 
sequence-'in field in the terminal table 
entry remains unchanged. 

The first message from a terminal must 
contain the same input sequence number as 
the sequence in (IJLQTSIN) field of the 
terminal table entry for that terminal. 

QTAM initially sets IJLQTSIN to 1. The 
user may at any time reset (by means of the 
CHNGT macro instruction) the contents of 
IJLQTSIN. If IJLQTSIN is reset before the 
maximum number (9999) is reached* the next 
incoming message must have the same number 
as IJLQTSIN. If IJLQTSIN is not reset 
before the maximum number is reached* the 
next incoming message after 9999 must be 
numbered zero. 
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In general, SEQIN causes the sequence-in 
field in the teririnal table entry to be 
incremented for each message having a 
correct sequence-in number in the header. 
If, however, CANCEIN. causes a message in 
errcr tc be canceled, or if an ECBLC macro 
causes retransmission of the first block of 
a message, the input sequence number is not 
incremented. In the latter case, the 
number is incremented when the first block 
is successfully retransmitted. 


When SEQOUT is specified, the user 
includes the value of n in his calculation 
of the value of the operand of the LPSTART 
macro instruction (see the LPSTART macro 
instruction description). 

r -— T --——-1 

|Operation|Operand | 

Y -+-—H 

|SEQOUT |n | 

l-J.--.-J 


Use of SEQIN is optional. For switched n 
terminals or terminals using Auto Poll, the 
SEQIN macro instruction, if used, must be 
preceded by a SOURCE macro instruction. 

SEQIN may be used only within the Receive 
Header subgroup. Its position must 
correspond to the position of the sequence 
number field relative to other header 
fields. 

r - T - 

|Operation|Operand 

Y - + - 

|SEQIN | tn] 


Is the number of characters to be 
inserted in the header for the output 
sequence number. The first character 
is always a blank. The maximum value 
of n is 5; that is, the maximum field 
size is five characters, allowing for 
a sequence number range between 0001 
and 9999. When the last available 
sequence number (99, 999, or 9999) has 
been issued to a message, the 
numbering cycle is repeated. The next 
-{ message is numbered zero. 

I 


n 

Is the number of character positions 
in the header field for the 
input-message sequence number. The 
maximum value of n is 4. If this 
operand is emitted, a variable-length 
field is assumed; in this case, the 
input-message sequence number must be 
followed by a blank used as a field 
delimiter. The value n does not 
include any blanks preceding or 
following the sequence number digits. 


Sequence Out (SEQOUT) Macro Instruction 


The SEQOUT macro instruction places an 
output sequence number in the header of 
each outgoing message. The IPS maintains a 
separate sequence count for each terminal 
and each terminal group (where group-code 
addressing is used). Each message for a 
terminal or terminal group is given a 
sequence number one greater than that of 
the preceding message for the same terminal 
or terminal group. A message in error 
rerouted via a REROUTE macro instruction or 
resent by the ECELC macro instruction 
retains the output sequence number 
originally placed in it. 

Use of SEQOUT is optional. If used, it 
must appear within the Send Header 
subgroup. Its position must correspond to 
the relative position, within the header, 
of the field into which the sequence number 
is inserted. Hence, it must perform the 
last editing cf the header. 


SKIP Macro Instruction 


The SKIP macro instruction causes 
skipping of either a designated number of 
nonblank characters, or all characters up 
to and including a designated character or 
sequence of characters. This permits the 
user to skip fields in the message header 
during processing. SKIP macro instructions 
must appear among other functional macro 
instructions in the same relative order as 
fields to be skipped appear among other 
header fields. 

Use of SKIP is optional. It may be used 
only within the Receive Header and Send 
Header subgroups. 

|Operation)Operand | 

Y --+-"I 

| SKIP |(n \ | 

| Hskipchrs/ | 

i._jJ:_ j 

n 

Is the number of nonblank characters 
to be skipped. The maximum value of n 
is the number of characters remaining 
in the header. 

skipchrs 

Is the character or sequence of 
characters designated to terminate the 
skip operation. The sequence must not 
exceed eight characters. The 
character or sequence of characters 
may be specified either as the 
characters themselves, or as the 
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hexadecimal equivalent of the 
characters. 

Example : A SKIP nacre instruction to cause 
skipping of five characters: 


r -— T ----- —t 

| Operation|Operand | 

I-- + -^ 

jSKIP |5 | 

L-JL- J 


Example : A SKIP macro instruction to skip 
characters up tc and including #= may 
specify 

1, the characters themselves* or 

2. the hexadecimal representation of the 
characters: 


r- T --—-- t 

| Operation|Operand | 

I*-+- ^ 

j SKIP j C"#= * j (1) 

| SKIP j X*7B7E * | (2) 

l -X- J 


SOURCE Macro Instruction 


The SOURCE macro instruction causes 
scanning of the scurce terminal code field 
in the header of each incoming message tc 
determine if the scurce code is valid. The 
validity check performed varies, depending 
on whether the source terminal is on a 
nonswitched or a switched line. Note that 
lines using Autc Pell are treated as 
switched rather than nonswitched lines* 

If the source terminal is on a 
nonswitched line, SCURCE verifies that the 
header contains the symbolic name of the 
same terminal that was invited to send a 
message; that is, the source code field in 
the header is compared with the name of the 
terminal tafcle entry for the terminal that 
was polled. If the names are net equal, an 
error flag is set in hit 6 cf the error 
half-wcrd for the line (see Figure 15). If 
the scurce terminal is a 2260 Lccai, SOURCE 
functions the same as for a terminal on a 
nonswitched line, with the exception that 
the 2260 Local is net polled. 

If the source terminal is cn a switched 
line, SCURCE can only verify that the 
source cede field in the header contains a 
valid name (that is, the name of an entry 
in the terminal table, hut not necessarily 
the name of the entry for the terminal that 
was polled). If a name that does not 
appear in the terminal tafcle is detected, 
an error flag is set in hit 6 of the error 
half-word. Use of SCURCE is required if: 


1. The SEQIN or COUNTER macro instruction 
is used in the Receive group of the 
LPS for switched terminals. 


2. The DIRECT, ERRMSG, POLLIMIT* or 

REROUTE macro instruction containing 
the "subfield" operand is used in the 
Receive group of the LPS for switched 
terminals. 


3. The name of a source terminal,, 

attached to an autopolled line, is to 
be placed at the location specified by 
the TRMAD keyword operand of the DTFQT 
macro instruction when a GET is issued 
in the related Message Processing 
Program. (See DOS QTAM Message 
Processing Program Services, Form 
C30-5003.) 

Note : On a switched line, if the 

connection has been established by the 
terminal, SOURCE must be issued in the LPS 
in order for messages on the destination 
queue for the terminal to be sent during 
this connection. 

In either case, SCURCE must precede 
these macros in the LPS. SOURCE may be 
used only within the Receive Header 
subgroup. Its position within the subgroup 
must correspond to the position of the 
source terminal code field relative to 
other header fields. 

f --- T -—--- 1 

|Operation|Operand | 

k -+-- 1 

j SOURCE j[n3 j 

L_J ___J 

n 

Is the number of characters in the 
source terminal code field of the 
message header. The maximum value of 
n is 8. If this operand is omitted, a 
variable-length field is assumed. In 
this case, the source terminal code 
must be followed by a blank used as a 
field delimiter. 

Time Stamp (TIMESTMP) Macro Instruction 

TIMESTMP causes insertion of the 
time-of-day into the header portion of a 
message. This function can be specified 
for incoming messages,, outgoing messages, 
or both. The time is expressed in the form 
bhh.mra.ss,, where b is a blank,, hh is the 
hours, mm the minutes,, and ss the seconds. 
Nine character positions are required for 
the complete time information^ However* 
the user may provide a shortened form (for 
example, omit the seconds) by reserving 
fewer than nine positions in the message 
header. 


Message Control Program 93 












Use of TIMESTMF is optional. If used, 
it irust appear in the Receive Header or 
Send Header subgroup. Its position within 
the subgroup irust correspond to the 
relative position, within the header, of 
the field intc which the tiire-of-day is 
inserted. 

When TIMESTMF is specified,, the user 
includes the value of nn in his calculation 
of the value of the operand of the LPSTART 
macro instruction (see the LPSTART macro 
instruction description). 

r -"f- 

|Operation|Operand 

^- + - 

(TIMESTMF jnn 

l_JL-_____ 

nn 

Is the number of characters of 
tiire-of-day information to be inserted 
in the header portion of each message. 
The maximum value of nn is nine, and 
the value specified reflects the 
presence of the leading blank in the 
time information. 

Note: TIMESTMP may be used only when the 

system includes the interval timer feature. 
However, it is net necessary that the 
interval timer he assigned to foreground 1. 
The time inserted into the header will be 
only as accurate as the time entered into 
the system by the operator. 


Translate (TRANS) Macro Instruction 

This macro instruction is not applicable 
to the IBM 2260-2848 Local, which is an 
EBCDIC device. 

The TRANS macro instruction causes the 
characters of an incoming or cutgoing 
mmessage to be translated from cne code to 
another. Incoming messages from a terminal 
are translated from the device cede fer 
that terminal type tc EBCDIC. Cutgoing 
messages are translated from EBCDIC to the 
transmission cede fer that terminal type. 
Translation is done character fer 
character. TRANS specifies the 
transmission code from which or intc which 
the message is tc be translated. 

TRANS is normally required in an IPS. 

It may be omitted if the source and 
destination terminals are of the same type 
and if the header analysis does not depend 
on the code. TRANS may be used in the 
Receive Header and/cr Send Header subgroups 
to translate only the headers of incoming 
and outgoing messages, respectively 
(message switching tc same terminal type). 
TRANS may be used in the Receive Segment 


and/or Send Segment subgroups to translate 
all segments* including header segments* of 
incoming and outgoing messages* 
respectively (inquiry processing and 
collection of data that is to be processed 
at a later time). 

TRANS must not be used in the Receive 
Header subgroup if EOB or EOBLC is used in 
the End Receive subgroup. Similarly* TRANS 
must not be used in the Send Header 
subgroup if EOB or EOBLC is used in the End 
Send subgroup. For outgoing messages* 

TRANS must appear immediately preceding 
PAUSE (if used) or the ENDSEND delimiter. 

I 

TRANS is not required in a message 
J switching application in which analysis of 
the header is not required of QTAM* 
provided that: 

1. The originating and the destination 
terminals are of the same type. 

2. The DIRECT macro* rather than the 
ROUTE macro,, is used to send messages 
to destination terminals,. 

Code translation is normally 
accomplished through tables provided by 
QTAM* although the user may prepare and use 
his own tables, if desired. For each 
transmission code* QTAM provides two 
tables: one to translate from transmission 

code to EBCDIC* and one to translate from 
EBCDIC to transmission code. Exceptions 
are IBM 2740* IBM 1050, and WU 33/35 for 
which three tables are provided. 

For WTTA lines* four translation tables 
are provided (two per 5-level code used). 
The user can modify these tables by using 
the four WTTA macro instructions RCVITA2* 
RCVZSC3* SNDITA2* and SNDZSC3* as explained 
above. 

All of the characters in the character 
sets of each of the types of terminals 
capable of communicating with the 
System/360 CPU can be represented within 
the computer. However, some characters 
valid for one type of terminal device may 
not be valid for another type of terminal 
device. In a message switching application 
in which messages are exchanged between 
dissimilar terminal devices, the user 
should either: 

1. Avoid placing in the message any 
characters that are not recognized by 
the destination terminal. 

2. Employ a user-written translation 
table that converts such characters to 
other characters that are acceptable 
to the destination terminal. 
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The character sets of the IBM 1050 and 
cf the IBM 2740 contain lowercase as well 
as uppercase alphabetic characters, When 
iressages froir either of these devices are 
sent tc teririnal devices cr processing 
prograirs that do net recognize codes for 
lowercase characters, the user should 
either: 

1, Use only the uppercase form of 
alphabetic characters, or 

2. Empicy the RCV1050F translation table 
(cr the user's equivalent) when 
transmitting freir the IEM 1050, cr the 
RCV2740F translation table (or the 
user's equivalent) when transmitting 
from the IBM 2740, Each cf these 
tables translates each incoming 
lowercase letter to the EECEIC 
representation cf that letter's 
uppercase equivalent. 


The SND2260 translate table converts 
lowercase alphabetic characters to 
uppercase so that the terminal receives 
only uppercase characters. 

Two sending translate tables are 
provided for TWX terminals. The SNDTWXE 
translate table converts EBCDIC into 
8-level code with even parity* The SNDTWXO 
translate table converts EBCDIC into 
8-level code with no parity. If the user 
specified SNDTWX as an operand, the 
SNDTWXE (even parity) translate table is 
used, and an MNCTE generated at assembly 
time informs the user that this is being 
done. 


r - T --- 

| Operation|Operand 

h-+- 

| TRANS j table-symbol 
L_-L- 


1 

I 

I 

j 


When iressages freir an IBM 1050 or an IBM 
2740 are sent to terminal devices or 
processing pregrams that do recognize codes 
for lowercase characters, the user may 
employ the RCV1050 translation table when 
transmitting from an IBM 1050, cr the 
RCV2740 translation table when transmitting 
from an IBM 2740. Each cf these tables 
translates incoming lowercase and uppercase 
letters into the corresponding EBCDIC 
lowercase and uppercase letters. 

Notes All names fer terminal table entries 
are assembled intc the terminal table as 
uppercase EBCDIC characters. In order for 
source and destination code information in 
message headers tc be recognized by the IPS 
macros as valid, such information must also 
appear to the IPS in uppercase EBCDIC form. 
Eor this reasen, scurce and destination 
codes entered intc message headers at an 
IBM 1050 must be entered in uppercase form, 
if the RCV1050 translate table is used. 

They may be entered in uppercase or 
lowercase if the RCV1Q50F table is used. 


table 

Is the name of the code translation 
table. Names of tables provided by 
QTAM are given in Figure 20. 


Example : A TRANS macro instruction to 

translate messages sent from an IBM 1030 to 

the computer: 

r- T -•---1 

|Operation|Operand | 

I—-+- i 

|TRANS j RCV1030 | 

L«- X ---i 

Example : A TRANS macro instruction to 

translate messages from the computer to an 

AT€T 83B3 terminal: 


r - T - - -1 

| Operation|Operand | 

t--+-^ 

|TRANS j SND8 3B3 j 

l_L_J 
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Type of Conversion 


1030 code to EECDIC 


r--—---- T 

| Table Name | 

j.-4 

| For incoming messages: | 

| RCV1030 I 

i i 

| RCV1050 j 

I I 

j RCV1050F | 

I I 

I I 

I I 

j RCV1060 j 

I ! 

j RCV2260 j 

I I 

j RCV2740 j 

I I 

j RCV2740F | 

I I 

I I 

I I 

j RCV83E3 j 

I I 

j RCV115A j 

I I 

j RCVTWX j 

I I 

| RCVARU j 

I I 

I I 

j RCVITA2 j 

I I 

j RCVZSC3 j 

I-- +- 

| For outgoing messages: | 

I SND1030 | 

I I 

j SND1050 j 

I I 

j SND1060 j 

I I 

j SND2260 j 

I I 

I I 

I I 

j SND2740 j 

I I 

| SND83B3 j 

I I 

j SND115A j 

I I 

j sndtwxe j 

I I 

I I 

j SNDTWXC j 

I I 

I I 

j SNDITA2 j 

I I 

j SNDZSC3 j 

L-JL 


1050 code to EECDIC 

1050 code to EECDIC (converts 
lowercase alphabetic 
characters to uppercase) 

1060 code to EECDIC 

2260 code to EBCDIC 

2740 code to EBCDIC 

2740 code to EECDIC 

(converts lowercase 
alphabetic to uppercase) 


8-level code to EBCDIC 
ARU code to EECDIC 

ITA2 code to EBCDIC 
ZSC3 code to EECDIC 

EBCDIC to 1030 code 

EBCDIC to 1050 code 

EBCDIC to 1060 code 

EBCDIC to 2260 code (converts 
lowercase alphabetic 
characters to uppercase) 

2740 code to EBCDIC 


EBCDIC to 8-level code 
(even parity) 

EBCDIC to 8-level code 
(non-parity) 

EECDIC to ITA2 code 


| Type of Terminal | 

--+-^ 

I I 

| IBM 1030 j 

I I 

| IBM 1050 j 

I I 

j IBM 1050 j 

I I 

I I 

I I 

j IBM 1060 j 

I I 

| IBM 2260 Remote j 

I I 

j IBM 2740 j 

I I 

j IBM 2740 j 

i I 

I I 

I I 

j ATST 83E3 j 

I I 

j WU 115A j 

I I 

| WU 33, 35 j 

I I 

| Audio terminals | 

j exceot IBM 3944 j 

1 ‘ I 

j WTTA | 

I I 

j WTTA j 

] I 

j IBM 1030 | 

I I 

j IBM 1050 | 

1 I 

j IBM 1060 j 

I I 

j IBM 2260 Remote | 

I I 

I I 

I I 

j IBM 2740 | 

I I 

j ATST 83B3 j 

I I 

j WU 115A j 

I I 

j WU 33/35 j 

I I 

I I 

j WU 33/35 i 

I I 

I I 

j WTTA j 

i I 

| WTTA | 


EBCDIC to ZSC3 code 


5-level (Eaudct) code to EBCDIC 


EECDIC to 5-level (Baudot) code 


Figure 20. Names cf Code Translation Tables Provided by QTAM 
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FUNCTIONAL MACRO INSTRUCTION DESCRIPTIONS 
(WTTA LINES) 


The following iracro instructions, 
RCVITA2, RCVZSC3, SNEITA2, SNDZEC3, and 
WRU, are applicable to WTTA lines only. 
The IPS for a WTTA line may alsc include 
functional iracrc instruction listed for 
nonaudio lines, except those whcse use is 
specifically restricted. The macro 
instructions which may not be used in a 
WTTA IPS are EREAHCFF, EOE, ECELC, and 
PCLLIN.IT, as well as the Audio functional 
macro instructions. 


RCVITA2 AND RCVZSC3 MACRO INSTRUCTIONS 


These macro instructions axe applicable 
tc WTTA terminals only. They allow the 
user to modify the two translation tables 
RCVITA2 and RCVZSC3, when necessary,, and 
thus produce new tables which can be used 
by the TRANS iracrc instruction. These 
macro instructions can be placed anywhere 
in the message control program cr can be 
assembled separately. 


Name 

r -- 

|Operation 

j 

| Operand 

_L .. 

symbol 

jRCVITA2 
± 

"T --- ~- 

| {Fx=hexchar,}... 


Name 

T 

|Operation 

i 

T 

(Operand 

<__L 

symbol 

T 

|RCVZSC3 

JL-»- 

T- - - 

| {Fx=hexchar ,K ,. . 


symbol 

Is the name cf the translation table 
used in the TRANS macro instruction; its 
length cannot exceed four characters. 


The 

permissible values 

for "x" are: 

For 

RCVITA2: 1. 2„ 

3. 

6, 7, 8„ 10 


through 
and 32. 

14 w 

19,„ 22,, 24„ 26. 

For 

RCVZSC3: 1„ 5* 

8» 

9„ 11. 12. 14„ 


15, 17 through 20* 22,* 24* 
26* and 32. 


Example; If a terminal operates in 5-bit 
International Telegraph Alphabet No. 2, 
combination 6 in figureshift representing 
the % character does not exist in table 
PCVITA2. Therefore, the user will create 
the required WTTA translation table (TBL) 
by writing: 

TBL RCVITA2 F6=6C 

where 6C is the hexadecimal representation 
of the % character in EBCDIC. 

Note: These macro instructions can 
be used to create several 
translation tables in the same 
program, provided these tables are 
given different names. This enables 
several terminals using the same 
code, but with differences in their 
graphic arrangement, to operate in 
the same installation* 


SNDITA2 AND SNDZSC3 MACRO INSTRUCTIONS 


These macro instructions are applicable 
to WTTA terminals only. They allow the 
user to modify the two translation tables 
SNDITA2 and SNDZSC3* when necessary* and 
thus produce new tables which can be used 
by the TRANS macro instruction. These 
macro instructions can be placed anywhere 
in the message control program or can be 
assembled separately. 


RCVITA2 

Specifies that table RCVITA2 is tc be 
modified and assembled. 

RCVZSC3 

Specifies that table RCVZSC3 is tc be 
modified and assembled. 

Fx=hexchar 

Specifies a modification tc the table 
concerned. 


r - — 

| Name 

|Operation 

- i . ... - 

"T -- --- 

(Operand 

j . . 

j symbol 

L 

1 

j SNDITA2 

|C Xyy=Fx„>- 


r 

| Name 

i— ^ 

T 

|Operation 
j. 

T 

[Operand 

i 

| symbol 

i 

|SNDZSC3 
-JL - 

j. 

|{ Xyy=Fx„1.., 


"F" means figureshift, 

"x" represents the number of the code 
combinaticn tc be translated* and 

"hexchar* is the hexadecimal 

representation of this character in 
EECDIC. 


symbol 

Is the name of the translation table 
used in the TRANS macro instruction? its 
length cannot exceed four characters. 

SNDITA2 

Specifies that table SNDITA2 is to be 
modified and assembled. 
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SNDZSC3 

Specifies that table SNDZSC3 is to be 
modified and asseirtled. 

xyy=Fx 

Specifies a modification to the table 
concerned, 

"yy" is the hexadecimal representation 
in EBCDIC cf the character to be 
translated. 

"F" means figureshift, and 

"x" is the number of the code 

combination tc be translated. 

The permissible values of "yy" are: 

2A, 3F, 4A through 50, 5A through 61, 6 A 
through 6F, 7A through 7F. 

Example: If a terminal operates in 5-bit 

International Telegraph Alphabet no, 2„ and 
if the user wishes tc assign the 
hexadecimal value X 0 6C* (ft character in 
EBCDIC) to combination 6 in figureshift (ft 
character tc be sent by the terminal), the 
required WTTA translation table (TBL) will 
be produced by writing: 

TBL SNDITA2 X6C=F6 

In the same way, the user can decide that 
the asterisk character (X f 5C' in EBCDIC) is 
tc be sent as a ft character. The required 
WTTA translation table (TEL) will be 
produced by writing: 

TEL SNDITA2 X5C=F6 

And if the user decides that both the ft and 
asterisk characters (X*6C f and X f 5C° in 
EBCDIC, respectively) are to be sent as a ft 
character, he will write: 

TEL SNDITA.2 X6C=F6,X5C=F6 

Note: These macrc instructions can be used 

to create several translation tables in the 
same program, provided these tables are 
given different names. This enables 
several terminals using the same code, but 
with differences in their graphic 
arrangement, to operate in the same 
installation. 


WED Macro Instruction 


To request an identification exchange 
during transmission of an output message , a 
WRU macro instruction is written in either 
the Send Header or the End Send subgroups 
of the LFS, If the identification sent by 


the terminal is not the same as that 
specified by the ID parameter of the 
corresponding TERM macro instruction,, the 
transmission-error bit (bit 8) and the 
message-not-sent bit (bit 12) of the error 
halfword for the line are set on as 
follows: 

• Bit 8 is always set on. 

• Bit 12 is set on only when an 
identification exchange has been 
requested by a WRU macro instruction 
written in the Send Header subgroup of 
the LPS, 

The WRU macro instruction requires no 
operands and is effective provided either 
WRU=YES or IAM=YES is specified in the 
corresponding DTFQT macro instruction. 

r - T ---- -1 

(Operation | Operand ( 

Y -+-^ 

j WRU | I 


INCLUDING A USER-WRITTEN ROUTINE WITHIN THE 
LPS 


The design of an LPS section is such 
that a serially-reusable,, user-written 
routine can be included. Linkage to a 
closed user-written routine can be included 
in any subgroup within the IPS There are 
several reasons why the user might include 
such a routine. 

There may be no IBM-provided LPS routine 
to process particular information he wishes 
included in his message headers. Or,„ he 
may desire to expand the scope of an 
IBM-provided LPS routine (for example, to 
execute his own error-correction routines 
after the ERRMSG macro instruction 
indicates an error). A third case might be 
processing a header field in a manner 
entirely different from the way an 
IBM-provided LPS routine handles fields of 
this type. 

To include a user-written, closed 
routine, the user must provide his own 
linkages. QTAM requires that the 
user-written routine save and restore the 
registers by standard register saving 
conventions. Register 13 contains the 
address of a QTAM-provided save area to be 
used for this purpose. If the user-written 
routine calls a second user-written 
routine, it must provide its own save area, 
etc. Figure 21 shows the control flow 
between an LPS and a closed, user-written 
routine* 
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Eefore entering the IPS section* the IPS 
control routine initializes certain 
registers with data that is used by irany of 
the IPS iracro instructions in performing 
their functions. Fcr this reason, the 
registers must he preserved. The register 
contents are described in Appendix E and 
may be useful tc the user in coding his own 
IPS routine. Fcr example, if the 
user-written routine processes a field in 
the message header, the scan pointer 
register (register 5) may be used for 
scanning the field; if used, it must be 
updated tc point tc the end of the field 
(as described in Appendix D) upcn return to 
the IPS. 



Figure 21. Activation of a Closed,, Eser 
Written Routine in the IPS 


The user also has the capability to 
include his own instructions as in-line 
code in the IPS. If any of the following 
registers are required for other than their 
intended purpose (see Appendix D)„ they 
must be saved and restored before execution 
of the next (in-line) IPS macro 
instruction: register 4* 5* 6* 7„ 8„ 9„ 

and 13. If any of the following registers 
(work registers for the LPS macro 
instructions) are used, they must be saved 
before execution of the next LPS macro 
instructions and restored when needed: 
register 2, 3,* 10„ 11,„ and 12. 


Note: Issuance of a Supervisor WAIT macro 

instruction from a user-written LPS routine 
(or in-line in the IPS) halts all 
processing of LPS macro instructions in 
the message control program until the 
condition being waited for is satisfied. 
WAIT* therefore,, should either not be used* 
or should be used with extreme care. The 
ATTACH and DETACH macro instructions may 
not be used in a user^written LPS routine. 
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NETWORK CCNTRC1 FACILITIES (NCNADDIO LIMES) 


CTAM provides a variety of facilities 
which permit the user to examine and 
dynamically modify the status of the 
telecommunications network. These 
facilities (and seme additional ones) are 
alsc available in a message processing 
program (refer to the DOS Q1AM Message 
Processing Program Services publication). 

Macro instructions are provided by QTAM 
to examine and modify the status of the 
system at the time the message control 
program initiates and activates the system. 
Execution cf these macro instructions must 
occur between that cf the OPEN and ENEREADY 
macro instructions. The user should be 
aware that as soon as execution of the OPEN 
macro instruction has completed* it is 
possible for a dialed line to be activated* 
in which case there nay be some danger in 
attempting to change the terminal table* 
for instance. 

Macro instructions which may be used to 
examine and modify the status of a nenaudio 
system enable the user to dynamically: 

• Activate a stepped line (STARTIN macro 
instruction). 

• Examine the four cumultive counters 
fer a line* and reset the threshold 
counters (CCPYC macro instruction). 

• Examine and modify the terminal table 
entries (CCPYT and CHNGT macro 
instructions). 

• Examine queue control blocks for DASD 
destination and process queues (COPYQ 
macro instruction). 

fchen these macro instructions are used 
in the IPS* QTAM ensures that register 13 
contains the address of an 18-wcrd save 
area. 


ACTIVATING A STEPPED LINE 


QTAM provides means of activating a 
stopped line though the STARTIN macro 
instruction. 


Start line (STARTIN) Macro Instruction 


STARTIN can be used to either: 


1. Allow message transmission to resume 
on a particular line in a 
communication line group; or 


2. Allow message transmission to resume 
on all lines in a communication line 
group. 

3. Allow message transfer to resume for 
an IBM 2260-2848 Local line group. 

The user must have previously opened the 
line group in the message control program. 

If a line or line group is deactivated 
by a STOPLN macro instruction,* issued in 
the message processing program* or if a 
line was opened idle* STARTIN must be 
issued before message transmission on that 
line or line group can resume. 

In all the above cases,* the presence of 
an active polling list is a prerequisite 
for message transmission. (An active 
polling list is one in which the second 
byte of the list is a nonzero character ~ 
this character is initialized as a 1 and 
can be changed by the CHNGP macro 
instruction.) If STARTIN is used* polling 
of input lines or receipt of messages from 
2260 Locals begins after the execution of 
that macro instruction. Initial polling of 
input lines in a line group and receipt of 
messages from 2260 Locals begins after the 
execution of the ENDREADY macro expansion 
in the message control program. 

f -T -T---1 

(Name |Operation)Operand | 


j[symbol] jSTARTLN j filename* (rln\ j 

I I I lALL/ | 

L-J.-I-J 

symbol 

Is the name of the macro instruction, 
filename 

Is the name of the DTF table for the 
line group containing the line to be 
reactivated. It must be identical to 
the name of the DTFQT macro 
instruction that generates the DTF 
table for the line group. 

If register notation is used*, the 
address of a location containing the 
name must be in the general register 
designated. The field that contains 
the name must be eight bytes (CL8) in 
length. (Padding with blanks is 
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required for names less than eight 
bytes.) 

rln 

Is the relative line number, within 
the line group, of the line to be 
reactivated. If register notation is 
used, the general register specified 
must contain the relative line number 
in binary form. 

ALL 

Specifies that all lines in the line 
group are tc be reactivated. 

Error returns from this macro instruction 
are contained in Appendix G, 


EXAMINING AND MODIFYING LINE ERECR COUNTERS 


Eight counters are provided for each 
line in the system: four threshold 
counters and four cumulative counters. 

Each cumulative ccunter corresponds tc one 
of the threshold counters, The threshold 
counters keep a ccunt of: 

1. Transmissions 

2. Data checks 

3. Intervention required errors 

4. Nontext timeouts 

For further information, refer to the 
Error Recovery P r ocedures section. 


Copy Error Count e rs (CQPYC) Nacre 
I nstruction 

This macro instruction does not apply to 
the IEN 2260-2848 Local, CCPYC causes the 
four cumulative counters of the line 
specified to be placed into a designated 
work area. The threshold counters are 
reset to 0, 

r - T - T —-T 

(Name |Operation|Operands | 

I-- + -4—-i 

|tsymhcl] |CCPYC | ternnaire,rln,workarea | 

l——__^_ X _JL-J 


symbol 

The name of the macro instruction, 
termnaire 

The name of any terminal whose error 
counters are tc be copied. If 
register notation is used, the general 
register designated must contain the 
address of a location containing the 


name of the terminal. The field that 
contains the name must be n bytes 
long, where n equals or exceeds the 
length of the longest name of any 
terminal table entry. If an invalid 
terminal name is specified, no data 
movement takes place. An error 
indicator of X'20 f is returned in 
register 15. If no error is detected, 
register 15 contains 0. 

rln 

The relative line number,, in the line 
group, of the line over which the 
terminal communicates with the 
computer. If this operand is not 
used,, its absence must be indicated by 
a comma. 

workarea 

The address of the area into which the 
information is placed. The size of 
the work area must be ten bytes. If 
register notation is used, the general 
register designated must contain the 
address of the work area. 

Bytes one through four of the workarea 
contain the number of transmissions; 
bytes five and six, the number of data 
checks; bytes seven and eight, the 
number of interventions required 
errors; and bytes nine and ten* the 
number of timeouts. 


EXAMINING AND MODIFYING TffE TERMINAL TABLE 


QTAM provides macro instructions that 
enable the user to examine and change 
dynamically the control information 
contained in a terminal table entry. 

The COPYT macro instruction causes the 
contents of a specified terminal table 
entry to be copied into a work area. This 
macro instruction can be used in 
conjunction with the CHNGT macro 
instruction, which substitutes a new 
terminal table entry for a superseded one. 
The user issues a COPYT, examines the 
information and changes it if necessary, 
and issues a CHNGT. 


Copy Terminal Tabl e Entry (COPYT) Macro 
Instruction 


COPYT moves the information contained in 
a specified terminal table entry into a 
designated work area. The terminal table 
entry can be either a single terminal, 
group-code, distribution list,, or process 
program entry. Formats for each of these 
entries are shown in Appendix A. 
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|Name jOperation jOperand 


j [symbol] |CCPYT jtermname,wcrkarea j 

l -x---x-J 

symbol 

Is the name cf the macro instruction, 

termname 

Is the name cf the terminal whose 
terminal table entry is to be copied. 
If register notation is used* the 
general register designated roust 
contain the address of a location 
containing the name of the terminal; 
the field that contains the name must 
be n bytes long, where n equals or 
exceeds the longest name of any 
terminal table entry. If an invalid 
terminal name is specified, no data 
movement takes place; the routine 
linked to by the CCPYT macro 
instruction returns an errcr code of 
X f 20V, right-adjusted in register 15* 
If no errcr is detected, register 15 
contains zerc. 

wcrkarea 

Is the address cf the area into which 
the information is placed. The first 
byte of the work area receives the 
first byte cf data from the terminal 
table entry. The maximum size cf the 
work area is 255 bytes (the maximum 
size of a terminal table entry). If 
register notation is used, the general 
register designated must contain the 
address of the work area. 


Change Terminal Table Entry (CHNGT) Macro 
Instruction 


CHNGT moves the information for a 
terminal table entry from a designated work 
area to the terminal table area allocated 
for that entry. CHNGT causes the entire 
contents of the superseded terminal table 
entry, except for the sequence-in 
(IJLQTSIN) and sequence-out (IJIQTSCT) 
fields, to be changed. The IJLQTSIN and 
IJLQTSCT fields are net changed because of 
the pcssibility that a message may be 
received between the moment the entry is 
copied and the moment it is changed. This 
would cause a sequence-number error to 
occur. In order to change the entire 
contents, including IJLQTSIN and IJIQTSOT, 
the user must precede the CHNGT macro with 
a STCFLN macrc fer the line to which the 
affected terminal is attached. CHNGT does 
not change the device access area (low 
order 24 bytes) of the terminal table entry 
for an IBM 2260 Iccal. 


CHNGT is normally preceded by the COPYT 
macro instruction and instructions to 
examine and modify the contents of the 
copied terminal table entry. The user must 
be certain that the new terminal table 
entry contains all the information required 
for proper execution of QTAM. The format 
of the terminal table entries and the 
information contained in each field are 
contained in Appendix A. 

r - T -—T-1 

|Name J Operation |Operand | 

i*--i-+-1 

|[symbol]|CHNGT | termname,, workarea | 

symbol 

Is the name of the macro instruction, 
termname 

Is the name of the terminal whose 
terminal table entry is to be 
replaced. It must be the same as a 
name that appears in the name field of 
a TERM, PROCESS, or LIST macro 
instruction. If register notation is 
used, the address of a location 
containing the name must be in the 
general register designated; the field 
that contains the name must be n bytes 
long, where n equals or exceeds the 
longest name of any terminal table 
entry. If an invalid name is 
specified, no data movement takes 
place; the routine generated by CHNGT 
returns an error indicator of X*20", 
right-adjusted in register 15 (?ero, 
if no error is detected). QTAM 
subsequently disregards the new 
terminal table entry and continues to 
use the old. 

workarea 

Is the address of the area from which 
the information is moved. If register 
notation is used, the general register 
specified must contain the address of 
the work area. If the new entry does 
not equal the size of the old entry, 
no data movement takes place. An 
error indicator of X 8 10 f is returned 
in register 15 (zero, if no error is 
detected), and QTAM continues to use 
the old entry. 


EXAMINING AND MODIFYING POLLING LISTS 


QTAM provides macro instructions that 
enable the user to examine and modify the 
contents of the polling list for a line. 

The COPYP macro instruction causes the 
contents of a specified polling list to be 
copied into a work area. This macro 
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instruction can he used in conjunction with 
the CEKGP iracro instruction, which can 
substitute a new polling list fcr a 
superseded one. The user issues a CCFYP, 
examines the information and changes it if 
necessary, and issues a CHNGP. CHNGP can 
alsc he used tc step cr restart polling of 
the terminals on a line. 


Copy Polling List (CCPYP) Macro Instruction 


COFYP causes the polling list for a 
specified line tc he copied intc a 
user-designated werk area. The format of 
the polling list is shown in Appendix A. 

f-T-T- 1 

|Name | Operation|Operand | 

K-“+-+- i 

|Csymtcl]| CCPYP |filename,rln„workarea| 

i- ± -jl_J 

symhcl 

Is the name cf the macro instruction, 
filenane 

Is the name cf the ETF table fcr the 
line greup containing the line whose 
polling list is to he copied. It must 
he identical tc the name of the ETFQT 
macro instruction that defines the ETF 
table for the line group. 

If register notation is used,,, the 
address cf a location containing the 
name must be in the general register 
specified. The field that contains 
the name must be eight bytes (CI8) in 
length (padding with blanks is 
required fcr names less than eight 
bytes). 

rln 

Is the relative line number, within 
the line greup, of the line whose 
polling list is to be copied. If 
register notation is used, the user 
must have previously placed the 
relative line number (in binary form) 
in the general register designated. 

werkarea 

Is the address cf the work area intc 
which the polling list is to be 
copied. The first byte cf the work 
area receives the first byte of data 
in the polling list. The size cf the 
area necessary can be determined from 
the polling list format shewn in 
Appendix A. If register notation is 
used, the general register specified 
must contain the address of the work 
area. 


Error returns from this macro instruction 
are contained in Appendix G. 


Change Polling List (CHNGp) Macro 
Instruction 


CHNGP can either: 

1. Place a new polling list in the 
polling list area for a specified 
line; or 

2. Change the status of a polling list 
for a specified line. 

CHNGP should be used to change only the 
status of a polling list associated with an 
IEM 2260-2848 Local line group. The 
terminal entries in the list are used only 
at Open and Close times and should not be 
modified. A CHNGP macro with the =C W O' 
operand can be used to temporarily stop 
receipt of messages from all 2260 Locals in 
the line group. 

With autopolled terminals: 

• To deactivate - use CHNGP and send a 
message to or from the terminal. 

• To activate - use CHNGP and send a 
message to the terminal. 

r- t-t - —i 

|Name | Operation!Operand | 

h- + -- + —-j 

|[symbol]| CHNGP | filename,rln„ | 

j | j (workarea) j 

I I I <=C’0» | 

I I I l=C'l" ) | 

i-j.- ± -j 

symbol 

Is the name of the macro instruction, 
filename 

Is the name of the ETF table for the 
line group containing the line whose 
polling list is to be modified. It 
must be identical to the name of the 
DTFQT macro instruction that defines 
the DTF table for the line group. 

If register notation is used,, the 
address of a location containing the 
name must be in the general register 
designated. The field that contains 
the name must be eight bytes (CL8) in 
length (padding with blanks is 
required for names less than eight 
bytes). 

rln 

Is the relative line number, within 
the line group,, of the line whose 
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polling list is to be modified. If 
register notation is used* the user 
must have previously placed the 
relative line nuirber (in binary form) 
in the general register specified. 


wcrkarea 

Is the address of the area that 
contains the new polling list. The 
first byte of the polling list area 
receives the first byte of data in the 
work area. 


If the new polling list is larger than 
the initial polling list for the line 
generated at assembly time, no data 
movement takes place. An error 
indicator of X 8 10 u (zero, if no error 
is detected) is set in register 15. 
QTAM subsequently disregards the new 
polling, list and continues to use the 
old. 


Causes the second byte of the polling 
list to be changed to a zero. This 
results in the deactivation of the 
polling list; no further messages are 
received until the list is 
reactivated. 


Causes the second byte of the polling 
list to be changed to a one. This 
results in the activation of the 
polling list. If the polling list is 
for a nonswitched line, QTAM begins 
polling the terminals on the line and 
accepting incoming messages, if the 
procedure is followed by either: 


1. A STARTLN macro instruction for 
the line whose polling list was 
reactivated, or 


2. Sending a message to a terminal on 
the line whose polling list was 
reactivated. 


If the polling list is for a 2260-2848 
local line group, QTAM automatically 
resumes receipt of messages from the 
2260 Locals defined in the polling 
list. 

If neither (1) or (2) occurs, no 
polling takes place on the line. 

Other error returns from this macro 
instruction are contained in Appendix G. 


EXAMINING QUEUE CONTROL BLOCKS 


Each terminal table entry defined by a 
TERM or PROCESS macro instruction contains 
the address of the queue control block 
(QCB) for the DASD destination or DASD 
process queue on which outgoing messages to 
the destination(s) are placed. QTAM uses 
the QCB for: 

1. Placing each message on its 
appropriate DASD queue. 

2. Maintaining information on the status 
of the queue. 

The COPYQ macro instruction enables the 
user to examine a QCB to ascertain the 
status of the DASD destination or DASD 
process queue associated with the QCB. 

Figure 22 shows the contents and 
relative displacement of each field in the 
QCB that is of interest to the user. After 
issuing a COPYQ macro instruction to copy 
the QCB into a user-specified work area, 
the user can determine the contents of the 
fields from which he needs information. 

For example, he can determine the number of 
messages in the queue, or he can use the 
address of the queue on the disk to 
retrieve a message (see the RETRIEVE macro 
instruction description). 

Copy Queue Control Block (COPYQ) Macro 
Instruction 


COPYQ places the contents of a QCB into 
a specified work area. The user indicates 
the QCB desired by specifying the name of a 
terminal or the name of a DASD process 
queue. If the name of a terminal is 
specified, COPYQ places into the work area 
the QCB for the DASD destination queue 
associated with that terminal. If the name 
of a DASD process queue is specified, the 
QCB for the DASD process queue is placed 
into the work area. In both cases, the 
entire contents of the 32-byte QCB are 
provided. However, certain fields are used 
internally by QTAM routines and are not of 
interest to the user (see Figure 22). 

r- t-t--1 

|Name | Operation!Operand | 

j [symbol] j COPYQ j termnaire^workarea j 

symbol 

Is the name of the macro instruction, 
termname 

Is the name of the terminal or DASD 
process queue whose associated QCB is to 
be copied. Only the name of a single 
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terminal or process prograir terminal 
tafcle entry can fce specified (that is, 
the name specified in a TERM or PROCESS 
iracrc instruction). If an invalid name 
is specified* no data moveirert takes 
place. The routine linked tc by the 
CCP^Q macro instruction sets X*20* in 
register 15 as an error indicator. If 
the name specified is valid,, a 0 is 
placed in register 15. If register 
notation is used* the address of a 
location containing the name must fce in 
the designated general register; the 


field that contains the name must be n 
bytes long,, where n equals or exceeds 
the longest name of any terminal table 
entry. 


workarea 

Is the address of the area into which 
the contents of the QCB are placed. The 
area must be 32 bytes long (the size of 
the QCB). If register notation is used, 
the general register specified must 
contain the address of the work area. 


0 

1 

2 

3 

4 








15 


QNRA 

I 

16 

17 

18 

19 

20 21 

22 

23 

24 

25 

28 

29 

30 

31 

QRLN 

QDTF 

QMCT 

QNWA 


QBAK 


Note: All DSECT names have the prefix IJLQ. 

Legend 

QNRA 

Is the relative record address of the next message to be read from this DASD queue; that is, the next 
message to be processed or transmitted. 


QRLN 


QDTF 


QMCT 


QNWA 


QBAK 


Is the relative line number of the line associated with this queue. 


Is the address of the DTF table associated with this QCB. 


Is the number of complete messages on this queue. 


Is the relative record address where the next message for this queue will be placed. 


Is the relative record address of the last message placed on this DASD queue. 


Figure 22. Fermat of Queue Control Block (QCE) 
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EEACTIVATING THE TELECOMMUNICATIONS SYSTEM 


In order to terminate operation of the 
telecommunications system, the 
communication line group, the 7772 ECV 
vocabulary, and the EASE message queues 
files must be closed. However, before they 
may be closed, all message traffic in the 
system must cease, and all main storage 
process and destination queues opened in 
any message processing program must be 
closed. To accomplish this, the user must 
issue a CLCSEMC macrc instruction in a 
message processing program, and then close 
all Q1AM files opened in the message 
processing programs. During this 
procedure, QTAM controls line activity and 
monitors the closing cf QTAM files in the 
message processing programs. When all QTAM 
files opened in the message processing 
programs have been closed and line activity 
has ceased, control is returned to the user 
tc permit him to close the line group, the 
7772 ECV vocabulary,, and the EASD message 
queues. Deactivation of the system 
proceeds in the fcllcwing manner. 

When deactivaticn of the system is to be 
initiated, a CLCSEMC macro instruction must 
be issued in a message processing program. 

A recommended procedure is to send a 
special message tc a process queue from 
which a message processing program may 
obtain the message. The processing program 
recognizes the special message and enters a 
routine that issues a CLCSEMC. In 
addition, the partition issuing the CLOSEMC 
may have to signal any other processing 
partitions, via a PEI, to CLOSE its files 
and tc issue its ECJ. It is necessary to 
signal each process queue in the other 
partitions that dc net have the SYNCED 
option. 

When the CLCSEMC macro instruction is 
issued, the following action occurs. 
Outgoing message traffic continues on any 
lines that are net currently receiving 
messages. Meanwhile, incoming message 
traffic cn each line is limited to the 
message currently being received over that 
line. When the last block of the current 
message is received, no more incoming 
messages are accepted (that is, the line is 
not repolled or reenabled). As each such 
line becomes free, any outgoing messages 
that have been queued for terminals cn that 
line are sent. In this manner, incoming 
message traffic declines to nothing, while 
outgoing message traffic continues until 
all messages have teen sent. 

after CLCSEMC is completed, no further 
incoming messages are accepted ever any 


line in the system. Thus all messages that 
entered the system from a terminal have 
either already been processed or are in 
queue waiting to be processed. At this 
point,, the GET/PUT portion of the message 
processing program should be reentered to 
obtain and process any messages still 
remaining on the process queues. When a 
GET macro is issued for a process queue and 
the queue has been exhausted, return is 
made to a user-written termination routine, 
the address of which is specified in the 
FLUSHAD operand of the DTFQT macro used to 
define the MS process queue. This 
termination routine should consist of one 
or more CLOSE macro instructions to close 
the MS process queue and MS queue files and 
any other files opened in that message 
processing program. The user 8 s termination 
routine should then issue an EOJ macro to 
end execution of the message processing 
program. 

The user obtaining messages from 
multiple process queues in the same message 
processing program must include additional 
code in his termination routine to ensure 
that all messages have been processed. If 
all messages to be processed are from 
terminals,, he need ensure only that the 
FLUSHAD return has been made for each 
process queue before closing the QTAM 
files. If messages are being transferred 
(via PUT macros) from this or any other 
message processing program to the process 
queues, he should ensure, additionally,, 
that consecutive FLUSHAD returns have been 
made for all process queues. The latter is 
necessary because a message may arrive on a 
process queue (due to a PUT) after the 
FLUSHAD return has already been made for 
that particular queue. 

The QTAM Close routine monitors the 
closing of the QTAM files opened in the 
message processing programs. When it finds 
that all of these files have been closed,, 
and all outgoing message traffic has ended, 
the routine stops operations on each line 
in the system. When all lines have been 
stopped, control returns to %he user at the 
address in the message control program 
specified in the EOJAD keyword operand of 
the DTFQT macro for the first file opened 
in the message control program. This 
address must begin a user-written routine 
that deactivates the message control 
program. This deactivation routine must 
issue CLOSE macro instructions for each of 
the files opened in the message control 
program (that is„ the line group, message 
log, 7772 DCV vocabulary, DASD message 
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queues, and EASE checkpoint reccrds files). 
This user written section of code must be 
assembled as part cf the message control 
program. 

The DASD checkpcint records file (if 
used) must be closed after the 
communication line group files and before 
the DASE message queues file. The EASD 
message queues file must be the last QTAM 
file tc be closed. This is important, 
because closing this file constitutes 
deactivation cf the telecommunications 
system. After the first-opened file has 
been closed, no further references can be 
made to queues, control blocks, terminal 
table, polling lists, etc. The 
deactivation routine should end with an EOJ 
macro instruction in order to end the 
message control jcb. 


CLOSE Macro Instruction 


The CLOSE macro instruction is used in 
the message ccntrcl program tc deactivate 
any line group, EASE message queues, and 
message log files the user has included in 
his telecommunications system. The EASD 
checkpcint records file (if used) must be 
closed after the ncnaudio communication 
line qrcup files and before the DASD 
message queues file. The first-opened QTAM 
file must be the last QTAM file closed. 

This macro instruction, if used, must 
appear in a section cf code the address of 
which is specified in the EOJAD keyword 
operand cf the ETFQT for the first-opened 
QTAM file. 


r-r- t- 1 

| Name | Operation | Operand | 

1*- + - + --I 

| [symbol] | CLOSE \ filename,,... | 

l __-L_jl _i 


symbol 

Is the name of the macro instruction 
filename 

Specifies the symbolic addresses of the 
DTF tables associated with the files 
being closed. All files can be closed 
with one CLOSE by including the 
addresses of their DTF tables as 
operands. If register notation is used,, 
the addresses of the DTF table(s) must 
have previously been loaded into the 
general registers specified. 


Telecommunications System, Cancellation 


At any time, the user may issue 1052 
console requests to cancel his 
telecommunications system. However, in a 
QTAM application, the cancellation of the 
message control program also brings on the 
cancellation of the message processing 
programs. If a message processing program 
is cancelled in this way, that is, by 
program request, a dump of the message 
processing program may not be provided. To 
ensure that a dump of each QTAM partition 
is provided, the user must cancel each 
message processing program before 
cancelling the message control program. 
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QTAM SERVICE FACILITIES (NONAODIO LIKES) 


This section describes the following 
services that QTAM provides tc aid the user 
in network control, error recovery and 
testing: 


• Operator Ccntrcl Facility 

• Checkpoint/Restart Facility 

• Cn-line Terminal Testing 

• Error Recovery Procedures 

• Operator Awareness 

• CER/SDR Error Recording 


Warning: The discussion in this section 
is not applicable to audio lines. For a 
discussion cf these facilities for audio 
lines, refer tc the appropriate section. 


Warning: With multitasking, the iraintask 

cannot use STIXIT IT if QTAM is attached 
with operator control, checkpoint by 
interval timer, cr polling interval 
facilities in the application. 


OPERATOR CONTROL FACILITY 


The Operator Ccntrcl facility allcws the 
execution of QTAM macro instructions by 
special control messages received from 
specified operator control terminals. The 
QTAM macros supported under this facility 
are: CCPIC, CCF¥I, CHNGT, INTERCPT* 

RELEASED, STARTLIK,, and STCFLN. Two 
additional functions, INTRE1 and SWITCH* 
are also provided. These messages are 
summarized in Appendix I. 


The user has three choices fcr operator 
control support: 


1. Ncne,, 


2. Operator control facilities only, or 

3. Operator control facilities with error 
messages sent tc the operator control 
terminal(s). 

The following table summarizes hew each 
option may be specified. 


] Facility j TERMTBL Macro | OPCTL Macro | 

y -+--—+- 1 

| None | Not specified | Not defined | 

j,-—-—+-——+-—^ 

j Operator | Not specified | Defined | 

j control | j j 

| only | | | 

] Operator j OPCTL=chars | Defined j 

| control | j j 

I with 1 | | 

1 error | | | 

] message ] | | 

l____ —_JL_ ----- X ---J 

Error messages from the Error Recovery 
Procedures (but not error messages 
originating from the ERRMSG macro 
instruction) are normally sent to the IBM 
1052 system console. Specifying the 
OPCTL=chars operand under the TERMTBL macro 
instruction and defining the OPCTL macro 
instruction causes these error messages to 
be sent to the operator control terminal. 

If this is done,, error messages originating 
from errors on the operator control 
terminal are sent to the IBM 1052 system 
console. 

The format of input control messages 
must be as shown in the individual message 
description below. Fields are delimited by 
one or more blanks. 

If the control message (ctlmsg) field is 
incorrect* or if the source terminal is not 
an operator control terminal, the message 
is not processed by the operator control 
routine. If the function is invalid,, the 
message is returned to the source terminal 
as entered. If any succeeding parameters 
are invalid,, the results are unpredictable. 
If an error is detected in the data field, 
a shortened message which does not contain 
the data is returned. 


MESSAGE FORMATS AND DESCRIPTIONS 


The format of input control messages is 
discussed below. Output messages are 
limited to one buffer. Data is in 
hexadecimal format unless specified 
otherwise,. The control message requesting 
the information is returned to the operator 
control terminal,, followed by the 
information requested. 
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Copy Error Counters (CCPYC) 


The CCPYC operator control message does 
not apply to the IER 2260-2848 local. 


This message causes the four cumulative 
counters of the line specified to be 
printed at the source terminal. The 
threshold counters are reset to 0. The 
data is in decimal format, if the control 
message and the counters copied exceed 
buffer size, cnly that portion cf the 
output message that the buffer can contain 
is printed. 


r --- T - r - n 

(Identifier (Function (Operands | 

h-4- + -1 

|ctlmsg (CCPYC |termname rln j 

i--- x _ x _J 

ctlirsg 

The control message identifier. It 
must be the same as that specified in 
the CPCTI macro instruction. 

termname 

The name of any terminal fcr which 
counters are desired. 

rln 

The relative line number of the line 
in the line grcup. It must be in 
decimal. 


Change Terminal Table Entry (CHNGT) 


This message causes the data entered to 
replace the terminal table entry specified 
beginning at IJLQTSIN up to the end of data 
but not exceeding the entry itself. 


r- T - T -—i 

|Identifier 1 Function|Operands | 

j.--— +-+ - H 

|ctlmsg |CHNGT |termname data | 

L--L—„-JL- J 


ctlmsg 

The control message identifier* It 
must be the same as that specified in 
the OPCTL macro instruction. 


termname 

The name of the terminal table entry 
for the terminal. 


data 

The actual data that is to replace the 
terminal table entry. It must be 
entered continously,, in hexadecimal 
format,, ending with a blank, EOB„ or 
EOT, and beginning with the IJLQTSIN 
field of the terminal table entry. 

The sequence fields are changed only 
if the line is stopped. 


Copy Terminal Table Entry (COPYT) 


This message causes the terminal table 
entry beginning at IJLQTSIN tc be printed 
on the source terminal. The information is 
printed in hexadecimal. If the control 
message and the part cf the terminal table 
entry copied exceed buffer size, only that 
portion cf the entry that the buffer can 
contain is printed. 


| Identifier 

L ... , . 

— T -- T — - - - 

|Function(Operands 

i . . i ..... 

r — - 

(ctlmsg 

i— _ -- 

(CCPYT (termname 


ctlmsg 

The control message identifier. It 
must be the same as that specified in 
the CPCTI macro instruction. 

termname 

The name of the terminal table entry 
fcr the terminal. 


Intercept Message (INTERCpT) 


This message causes the suppression of 
all message transmission to the terminal 
specified. The terminal remains 
intercepted until a RELEASED operator 
control message is entered for that 
terminal (or a RELEASEM macro instruction 
is issued for that terminal in a message 
processing program). If the INTERCPT 
control message is used, the user must: 

1. specify an INTERCPT macro instruction 
in the End Send subgroup of the IPS 
for the terminal specified in termname 
with a mask which includes "terminal 
inoperative;" and 

2. specify the INTRCPT keyword operand in 
the OPCTL macro instruction. 


r --T—-- 1 

| Identifier {Function]Operands ( 

j.-4---4-—-—*—*1 

(ctlmsg |INTERCPT)termname | 
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ctlmsg 

The control message identifier* It 
must be the same as that specified in 
the CPCTL iracrc instruction. 

terirnaire 

The name of the terminal table entry 
fcr the terminal. 


Intercept and Release Messages (Line lest) 
(INTREL) 


This message causes the suppression of 
all message transmission to and from the 
terminal specified fcr a two-minute 
interval. After two minutes, messages are 
released until an unrecoverable error 
occurs, at which time the cycle begins 
again with intercept. This continues until 
a RELEASE** is issued. If the INTREL 
control message is used f , the user must 
specify an INTERCET macro instruction in 
the End Send subgroup of the IPS for the 
terminal specified in termname with a mask 
which includes "terminal inoperative." 

Note that if this message is to be used w 
the interval timer feature is required and 
must be assigned tc the foreground-one 
partition. 

If INTREL is specified for a line that 
has been deactivated by STOPLN, the 
operator awareness message INTREL NOT DONE 
is issued. 


Identifier 

|Function|Operands 

i I 

ctlmsg 

T T - --- 

|INTREL |termname 


ctlmsg 

The control message identifier. It 
must be the same as that specified in 
the CPCTL macro instruction. 

termname 

The name of the terminal in the 
terminal table* 


jIdentifier jFunction]Operands j 

| ctlmsg |RELEASEMjtermname | 


ctlmsg 

The control message identifier* It 
must be the same as that specified in 
the OPCTL macro instruction* 

termname 

The name of the terminal table entry 
for the terminal. 


Stop Line (STOPLN) 


This message removes a nonaudio 
communications line from active use* 

r - T -T---1 

(Identifier |Funct ion] Operands | 


j ctlmsg ] STOPLN j termname , TALL - ] j 

I I ] LrlnJ | 

i _ x _ j ---J 

ctlmsg 

The control message identifier* It 
must be the same as that specified in 
the OPCTL macro instruction* 

termname 

The name of any terminal on the line 
that is to be stopped. 

ALL 

Specified that all lines in the line 
group are to be stopped. 

rln 

Specifies in decimal form the relative 
line number within the line group of 
the line to be stopped. 


Start Line (STARTLN) 


Release Messages (RELEASEM) 


This iressage causes all intercepted 
messages with that terminal as the 
destination to be sent as well as new 
messages. That is, it resets the INTERCPT 
and INTREL condition for this terminal. If 
the RELEASEM conrrcl message is to be used, 
the user must specify the INTRCET keyword 
operand in the CPCTL macro instruction. 


This message causes transmission to 
begin or resume on a line or all lines in a 
line group, provided the line group is 
opened and has an active polling list. 


| Identifier 

h- 

| ctlmsg 

I 


T -*ar-—- 

|Function|Operands | 


j STARTLN | termname,, [ ALL] j 

I I LrlnJ | 

JL- X- _J 
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ctlirsg 

The control iressage identifier. It 
trust be the saire as that specified in 
the GPCTL nacro instruction. 

terirnaire 

The naire of any terminal on the line 
that is to he started. 

AIL 

Specifies that all lines in the line 
group are to be started. 

rln 

Specifies in decimal form the relative 
line number Viithin the line group of 
the line to he started. 


Switch Control Terminals (SWITCH) 


This message causes error information to 
be sent to the control terminal that is not 
presently receiving these messages instead 
of the present terminal. This message is 
only valid if the AITERK operand was 
specified in the CFCTL macro instruction. 


| Identifier 

L _ 

|Function|Operands 

j. - _ _ , | .. T _ . _ 

r 

| ctlirsg 

i__ 

jsKHCH j 


ctlmsg 

The control message identifier. It 
must be the same as that specified in 
the GPCTL macro instruction. 


CHECKPOINTING AND RESTARTING THE MESSAGE 
CONTROL PROGRAM 


£TAM provides optional checkpoint and 
restart facilities fcr the message control 
program. Checkpoint causes records tc be 
written either at: 

1. User-specified intervals, or 

2. A certain point in one or mere message 
processing programs 

on a checkpoint records file maintained on 
a direct access storage device (DASD). 

These records contain the information 
necessary to record the status cf the 
queues and the Teleprocessing network. In 
particular, the checkpoint record includes 
the polling lists, the terminal table, disk 
pointers and status information associated 
with each queue, and disk pointers and 
status information associated with each 


line. Note that the data in the buffers is 
not included in the checkpoint record. Two 
such checkpoint records are maintained in 
the checkpoint file along with a pointer to 
the most recent record. 

Should a system failure occur,, the 
Restart facility uses the data in the 
checkpoint records to reinitialize the 
system to the status it had at the time the 
last checkpoint record was written except 
for audio lines. This avoids excessive 
loss of time or message data. 


CHECKPOINTING THE MESSAGE CONTROL PROGRAM 


In order to use the Checkpoint facility, 

the user must: 

1. Allocate space on the DASD for the 
checkpoint records file. Space must be 
allocated on the DASD only the first 
time the file is used. To calculate 
the number of tracks required, refer to 
the section Direct Access Checkpoint 
Records File . 

2. Preformat the area allocated for the 
file. He must preformat each extent 
with a dummy record four bytes long, 
the first byte of which roust be zero. 
The checkpoint routine formats the 
other records needed. 

This formatting is necessary only the 
first time this area is used,, not each 
time the message control program is 
initiated. However,, if, because of a 
system failure, the file has not been 
closed and the user does not wish to 
restart, he must reinitialize 
(reformat) this file before initiating 
the message control program. An access 
method or utility other than QTAM must 
be used to format this area. 

Each extent formatted must have a 
format 1 label. The Clear Disk utility 
is recommended for formatting. 

3. Define the checkpoint records file with 
a DTFQT macro instruction. Refer to 
the section Direct Access Checkpoint 
Records File . 

4. Open and close the checkpoint records 
file. Refer to the description of the 
OPEN and CLOSE macro instructions. 

5. Define the mode of checkpointing by 
either: 

a. Specifying the checkpoint interval 
in the TERMTBL macro instruction,, 
or 
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b. Issuing CKREQ in the iressage 

processing program. (This macro 
instruction is described in the DOS 
QTAM Message Processing Proqr am 
Services ). 

If the CPINTV keyword operand is 
specified in the TERMTBL macro instruction, 
the message control program will be 
checkpointed at the given interval of time. 
The first checkpoint interval is initiated 
at the time of execution the ENEREAD* macro 
expansion. For further information, refer 
to TERMTBL Macro Instruction . 

If CKREQ is issued in the message 
processing program, the message control 
program is checkpointed whenever all 
message processing partitions have issued 
the CKREQ macro instruction. Fcr example, 
if there are two message processing 
partitions, and cnly one message processing 
partition has issued a CKREQ macro 
instruction, that partition enters a wait 
state until the other partition also issues 
a CKREQ macro instruction. At that time 
the checkpoint is taken. This puts all 
message processing partitions in 
synchronization with the message control 
program. Steps can be taken by the 
processing programs at the checkpoint to 
guard against duplicate messages following 
a restart. 

CPINTV and CKREQ are mutually exclusive. 
If both are specified, CPINTV takes 
precedence. If the CPINTV operand is 
specified and a processing program issues a 
CKREQ macro instruction, the CKBEQ macro 
instruction is ignered and the checkpoints 
are taken at the intervals specified in the 
CPINTV operand. An error code cf X*08 # is 
returned to the processing program in 
register 15. 


RESTARTING THE MESSAGE CONTROL PROGRAM 


fchen operating with the Checkpoint 
Restart facility, the user may restart the 
message control program at any time. 

Restart reestablishes the queues and the 
telecommunications network to the status it 
had at the time cf the most recent 
checkpoint (except fcr audio lines, which 
will have the same status as in an initial 
program load). Restart is accomplished by 
reloading the program. The checkpoint 
records file is examined and, if the file 
has been properly closed, normal operation 
takes place. If the file has net been 
closed, a restart operation is performed. 

After a restart has been performed, 
messages queued fcr sending to a terminal 
on a switched (dial) line are net 


automatically sent. The terminal must send 
a new message; after the message is 
received, the line is turned around and the 
messages on the destination queue are then 
sent. 

Note : Upon restart, the checkpoint file 
should be opened before any processing by 
the message processing program is resumed. 


SYSTEM DESIGN CONSIDERATIONS 


• Checkpoint does not terminate incoming 
message traffic before taking the 
checkpoint record. Some of the 
messages at checkpoint time may 
therefore be partially received. If a 
system failure does occur, these 
partially recieved records, as well as 
the records received after checkpoint 
time, must be reentered from the 
terminal after restart. 

• Messages on the DASD at restart that 
had not been completely sent to their 
destinations before the most recent 
checkpoint record was taken are sent, 
starting with the header segment 
whether or not the header segment had 
been sent before the checkpoint. 

• Lines in initiate or conversational 
mode at checkpoint time are in normal 
mode upon restart. 

• Lines stopped at checkpoint time remain 
stopped upon restart. 


ON-LINE TERMINAL TESTING 

The on-line terminal test facility 
provides tests that can be used by the 
terminal operator as a startup procedure, 
and by the IBM customer engineer for 
terminal checkout and diagnosis of terminal 
failure. 

The tests provided operate on-line with 
the user's problem program and in no way 
hinder user operation except for the line 
time required by the terminal tests to 
perform their function on the selected 
line. 

Tests requested from a terminal can be 
returned to that terminal, to any other 
terminal on the same line, or to any other 
terminal in the system. The tests allow 
message switching, comparison of incoming 
data to a stored pattern in core storage, 
all characters to be sent to the specified 
terminal, and test patterns for diagnosis 
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of failures in the SELECTRIC F typing 
element of the terminal, 

Bequests for the various tests are 
entered from a remote terminal and are 
identified by a test activation code of 
99999, The individual tests and terminal 
addresses are selected by seccndary 
activation codes. 

Tests are net provided for ncn-IEN 
terminals, for terminals associated with 
audio response units, or for the IBM 
2260-2848 Local. 

The tests available are described in 
Appendix K. 


EFRCR RECOVER? PROCEDURES 


The error recovery procedures are a 
comprehensive set cf procedures for dealing 
with all kinds of input/output errors that 
may occur within the telecommunications 
system. 

Open occurrence cf an input/cutput 
error, the error recovery procedures 
examine the sense tits and CSV* status bits 
to determine which type of error has 
occurred. Depending upon the type cf 
error, the following functions may be 
performed: 

1. The failing action is retried two 
times, and on the third occurrence of 
the error, an operator message is 
provided, 

2. The failing action is not retried,, and 
an operator message is immediately 
provided, 

3. The type cf failing action is counted 
in a threshold counter, or 

4. A combination of 1, 2, and 3, depending 
upon the type cf terminal on which the 
error was detected. 

Note: if the error is counted in a 
threshold counter, it is counted every 
time that it occurs* including both cf 
the twe retry attempts, Messages to 
the operator are normally sent to the 
IEM 1052 system console. Hcwever, if 
the CPCTL=chars eperand is specified in 
the TERMTBL macro instructicn, they are 
sent to the operator control terminal. 
Fcr further information,, refer tc the 
Operator Con t rol Facility and TERMTBI 
Macrc Instructicn sections. 


Eight counters are provided for each 
line in the system: four threshold 


counters and four cumulative counters. 

Each cumulative counter corresponds to one 
of the threshold counters. Threshold and 
cumulative counters are not provided for 
the IBM 2260-2848 Local. 


The threshold counters keep a count of 
the number of: 

1. Transmissions. 

2. Data checks. 

3. Intervention required errors. 

4. Nontext timeouts. 

Whenever any one of the three error 
threshold counters (but not the 
transmissions threshold counter) reaches a 
specified threshold value,, the following 
action is performed: 

| 1. A message is provided to the operator 
showing: 

a. The threshold value specified for 
each threshold counter* and 

b. The value in each threshold counter 
at this time. (The error count 
could exceed its threshold value if 
another error occurs after 
threshold is reached but before the 
message is written.) 

I 2, The threshold counters are reset to 0. 

Whenever the transmissions threshold 
counter reaches its threshold value* the 
threshold counters are reset to 0„ but no 
message is provided. 

The threshold values represent the 
number of the three types of errors 
considered excessive within a certain 
number of total transmissions. These 
values are specified in the THRESH operand 
under the DTF macro instruction for the 
line group in which the line is located. 

The threshold value for any of the four 
threshold counters must not be more than 
255. However, the threshold values 
specified for any of the three error 
counters should be enough less than that 
specified for the number of transmissions 
to allow an error message to be provided. 

If the THRESH operand is omitted* the 
following values are assumed: 

No. of transmissions: 255. 

No. of data checks: 10. 

No. of intervention required errors: 5. 
No. of nontext timeouts: 5. 

Error recovery procedures also provide 
the COPYC macro instruction. For further 
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information, refer tc CCPYC Macro 
Instruction*. 


OPERATOR AWARENESS 


Operator awareness messages are provided 
for all permanent and unrecoverable errors 
and excessive temporary errors as 
determined by the line error threshold 
counters. These messages are printed on 
the 1052 system ccnscle unless operator 
control (OPCTL macro instruction) is 
specified. When operator control is 
specified, all operator awareness messages 
pertaining to the operation of the data 
links are sent to the telecommunications 
system control terminal. An operator 
awareness message will be truncated if it 
cannot be contained in one buffer. (See 
the DCS Operating Guide for specific 
messages.) 


4QnnI text SYSnnn=cuu CCW=xxxxxxxxxxxxxxxx 
TI=xxxx (or EC=xxxxxxxxxx) 
CSW17=xxxxxxxxxxxxxx SK=xxyy LCB=xxxxxx 


(When CER/SDR is included in the system, 
the last line of this message is omitted.) 


where s 
4CnnI 

Is the standard message code for the 
operator. The internal component name 
is 4Q, the serial is nn, and the 
action code is I for informational 
(immediate operator action is not 
required). 

text 

Type of error detected. 

SYSnnn=cuu 

Is the symbolic unit assignment of the 
device, and cuu is the actual unit 
assignment cf the device. 

LCE=xxxxxx 

Is the address cf the line control 
block for the terminal or cf the Audio 
line control block for the Audio line. 

TI=xxxx 

Is the terminal ID (polling or 
addressing characters) in hexadecimal 
format. If only one polling character 
is used, it will be left justified in 
this field. This field is not 
included in Audio messages. 


DC=xxxxxxxxxx 

Is the hexadecimal representation of 
the dial characters for the terminal. 
Maximum number of digits is eight. 

This field is not included in Audio 
messages. 

CSW17=xxxxxxxxxxxxxx 

Is bytes 1 through 7 of the channel 
status word as specified in the 
channel command block (CCB) in 
hexadecimal format. 

CCW=XXXXXXXXXXXXXXXX 

Is the failing channel command word 
(CCW) in the channel program in 
hexadecimal format. 

SN=xxyy 

For all terminals except 2740 Model 2 
xx is the sense byte of the failing 
command in hexadecimal format, 
yy is the sense byte of the error 
recovery CCW (if any) in 
hexadecimal format. 

For 2740 Model 2 terminal 
xxyy is the hexadecimal 

representation of the 2-toyte 
response received from the 
terminal (see the 2740 SRL for 
possible responses and their 
meanings). 

The format of the error count threshold 
message is: 

4Q00I LINE ERROR THRESHOLD REACHED 
SYSnnn=cuu TR=aaa/bbb DC=ccc/ddd 
IR=eee/fff TO=ggg/hhh 


where : 

TR=aaa/bbb 

aaa is the threshold value for the 
number of transmissions specified in 
the DTF/keyword THRESH, and bbb is the 
number of transmissions attempted up 
to the time an error threshold was 
reached. This information is in 
decimal format. 

DC=ccc/ddd 

ccc is the threshold value for the 
number of data checks specified in the 
THRESH parameter, and ddd is the 
number of data checks that occurred,, 
in decimal format, in the past bbb 
transmissions. 

IR=eee/fff 

eee is the threshold value for the 
number of intervention required errors 
specified in the THRESH parameter, and 
fff is the number that occurred, in 
decimal format, in the past bbb 
transmissions. 
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TC=ggg/bhh 

ggg is the threshold value for the 
number of nontext timeout errors 
specified in the THRESH parameter, and 
hhh is the nuirter that occurred, in 
decimal format, in the past bbfc 
transmissions. 


CER/SER ERROR RECORDING 


QTAR provides optional OER (Outboard 
Recorder) and SDR (Statistical Eata 
Recorder) facilities for recording error 
information. CER/SDP helps to reduce the 
time the system is inoperative by providing 
more information for the diagnosis of line 
and terminal problems. OER/SER is net 
supported for audio devices. 

The CBR facility writes one record on 
disk for each permanent error (exceptions 
— time-out and intervention reguired on 
responses to polling and addressing,, and 
time-out on a read test command; these are 
considered to be cperational errors). The 
error recorded in an CBR record is the last 
error which occurred within a ncnrecovering 
series of retries. Each OER record 
contains the following information: 

• Date 

• Time 

• Pregram IE (always shown as "QTAtf MCP") 

• First CCW 

• Failing CCW 

• Channel and unit 

• CSW (key field will always be shown as 

X*30*, regardless of its actual value) 

• Sense data 

• Device type 

• "Felling characters" 

Actual data in this field will be: 

1. Polling and addressing characters 
for leased-line 1050, 1030,, 1060, 
2848, 2740C* 2740E, 83E3, and 115A 
terminals. 

2. Zeros fer 2260-local, WTTA, 2740A, 
and 2740F terminals. 

3. Eial digits (up to a maximum of 8) 
for switched lines when the actual 
terminal is known. 

4. Zeros fer switched lines when the 
terminal identity is not known by 
the program. 

• Logical unit 

The SER facility maintains an S^byte set 
of counters in main storage for each line 
or terminal (whenever the specific terminal 


identity is known to the program). A count 
of "total transmissions" is kept in a 
1-byte counter, and counts of all the 
errors are kept in 1/2-byte counters. The 
following counters are kept: 


For Devices on a 

Eyte-Halfbyte 

2701,. 2. or 3 

A=lst halfbyte 
E=2nd halfbyte 

Total transmissions 

0 

Unit exception on a 
write 

1—A 

Time-out on prepare or 
nontext read 

1—B 

Time-out on dial, 
enable, or disable 

2-A 

Intervention required 

2-B 

Overrun 

3-A 

Bus-out check 

3-3 

Data check on write 

4-B 

Data check on read 

5-A 

Data check on poll 

5-B 

2740-2 terminal 
electronic error 

6-A 

2740-2 terminal I/O 
error 

6-B 

2740-2 transmitting 
parity error 

7-A 

2740-2 receiving 
parity error 

7-B 

For 2848-2260 Local 

Byte-Half byt e 

Total transmissions 

0 

Bus—out check 

3-B 

Equipment check 

6-A 


Transmissions and errors are counted for 
SDR only during the first attempt at an I/O 
operation, not during any retries. When 
any counter reaches its maximum value (255 
for total transmissions; 15 for errors),, 
the entire 8-byte set of counters is added 
to a corresponding set of larger numbers on 
disk. The counters in main storage are 
then reset to zero. 

Each SDR record on disk contains the 
following information: 
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• Channel and unit 

• "Polling characters" (see CBR record 
for actual data in this field) 

• Kind of device 

• SCR counters 

Rote that there will be one SDR record 
on disk for each combination of line 
address and "polling characters" data used. 
For example, a switched terminal on line 
X*039* with phone number 1234 could have 
its transmissions and errors divided 
between two different SDR counter sets: 

• line 039, "pclling characters" 

00000000 when the terminals ID was 
net known to the program (counting by 
line) 

• line 039, "polling characters" 

12340000 when the terminals*s ID is 
known (counting by terminal) 

During normal closedown or cancel 
procedures, QTAM automatically adds all SDR 
counters in main storage to their 
corresponding disk counters. 

If a permanent wait state occurs, the 
SDR counters in main storage are not added 
to their corresponding disk counters. 


These counts will be lost unless they are 
manually looked up in the dump of main 
storage. A table of SDR counter sets is 
generated at the label IJLQOTBL in the 
TERMTBL macro expansion. A 2-byte offset 
into the SDR counter table can be found in 
the TERM entry*s IJLQTSDR field for counts 
by terminal, and in the last halfword of 
the LCB for counts by line. The first 
counter set has an offset of 8? zero is not 
used. 


The OBR and SDR records are kept in a 
special recorder file (SYSREC) on disk, and 
are converted into printed form by a 
utility program, EREP, running independent 
of QTAM (for operating instructions see DOS 
System Control and System, Service Programs , 
Form C25-5036). 

To include the OBR/SDR option in the 
QTAM Message Control Program: 

• Include the OBR/SDR option in the DOS 
system at system generation time? 

• Specify the OBRSDR operand in the 
TERMTBL macro? and 

• Include two extra bytes (for SDR 
counter assignment) in the 
ACLOC=integer operand of each line 
group DTFQT macro instruction. 
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AUDIO MESSAGES 


The remainder cf this document, except 
for the appendices, is concerned with 
prcgrairiring fcr audic message ccntrol. All 
the information needed to control an 
audio-cnly system is provided in the 
following sections. In addition, all 
necessary considerations for programming 
for a mixed audio and nonaudic 
configuration are provided. Wherever 
possible and necessary, nonaudic 
considerations are included with the audio 
discussion wherever there is overlap. This 
section thus provides a complete 
documentation of programming for audio-only 
cr mixed configurations. 


AUDIO MESSAGE FORMATS 


Audio messages include input and output 
messages that consist of a complete 
nonsegirented text, without any header. 

Each line used fcr the transmission of 
audio messages can operate in one of the 
three following modes: 

• Information mode. The computer 
receives no data, but sends an 
invariable audio output message (called 
an informational message), to the audio 
terminal connected on line. 

• Inquiry mode. As soon as the calling 
terminal is connected on line,,, the 
computer either reads the input 
message,, called the inquiry message, if 
the user has requested an initial read 
operation; cr sends an invitational 
message to the calling terminal tc 
signal that the computer is ready to 
read the inquiry message, if the user 
has requested an initial write 
operation. In both cases, the inquiry 
message is received by the computer,, 
stored into an input buffer, and 
processed by the message processing 
program to produce the appropriate 
response message. From this response 
message* the message control program 
issues an audio cutput message which, 
through the audio response unit, 
becomes the audio answer received by 
the calling terminal. 

• Conversation mode. This mode is an 
extension of the inquiry mode. It 
enables a sequence of inquiry messages 
and audio answers, called a 
conversation, tc be set up within the 
same telephone communication. 


Audio Input Messages 


An audio input message consists of a 
series of alphameric characters which have 
been keyed or dialed on an audio terminal. 


The input messages received by an audio 
response unit are transferred,, character by 
character* to System/360 main storage and 
assembled in input buffers. The messages 
dialed on IBM 3944 Dial Terminals are 
directly assembled in EBCDIC 
representation; but all other messages are 
assembled in ARU code which is a 8-bit byte 
representation of the transmission code 
used by the audio terminals. 


One input buffer is associated with each 
line. The length of an input message must 
exceed neither 255 bytes nor the length of 
the input buffer into which this message 
will be stored. 

The end of an input message is indicated 
by one of the following: 

• An EOT (end-of-transmission) character 
sent by the audio terminal. 

® A timeout: a character has not been 
keyed or dialed in due time on the 
audio terminal. 

• An overlength: the length of the input 
message exceeds the size of the 
corresponding input buffer. 

The message control program automatically 
recognizes the end of a conversation or the 
cancellation of an inquiry at its 
beginning,, when the first character of an 
input message is an EOT character or when a 
time out has occurred and no character has 
been sent by the audio terminal. 

However, the first character of an input 
message can be recognized by the message 
control program as a code,,, if it has been 
specified as such by the user in an 
appropriate macro instruction. This code 
can be : 

• A predetermined message-type indicator 
which identifies a message to be 
processed in a special way by the 
message control program. This 
indicator is passed to the message 
control program with the remainder of 
the text of the message. 
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• A repeat cede, used in conversation 
mode only, which enables the last audio 
answer to be repeated, ftn invitational 
message cannot be repeated. 


ftudio Output Messages 


The response message produced in a work 
area by the message processing program 
consists of an ordered sequence of 
addresses (address chain) specifying the 
location of each audic word tc be sent to 
the calling terminal and preceded by two 
leading bytes indicating the length of this 
address chain. 

One address chain buffer is associated 
with each line. The address chain is 
transferred tc the address chain buffer,, 
and its length must exceed neither 255 
bytes nor the length of the address chain 
buffer. 

When the line is attached to an IBM 
7770, the address chain is made up of 
addresses on a magnetic drum frem which 
this audio response unit fetches the words 
comprising the audio answer and sends them 
to the calling terminal. In this case, the 
address chain is identical to the audio 
output message sent by the computer. 


When the line is attached to an IBM 
7772, the address chain includes one or two 
types of DCV word address. The first type 
indicates the location of a DCV word on 
DASD. The second type indicates the 
relative position of a DCV word in a word 
table permanently kept in main storage. 

When at least one line attached to an IBM 
7772 transmits DCV words dynamically 
retrieved from DASD, the user must define 
DCV buffers (DCV buffer pool); these DCV 
buffers will receive the DCV words from 
which the audio response unit will send the 
audio answer. In this case, the audio 
output message sent by the computer is m^de 
up of DCV words. 


AUDIO MESSA3E FLOW 


This section describes the flow of an 
audio message through a system operating 
under DOS QTAM from its receipt at the 
computer to the audio transmission to the 
calling terminal. Figure 23 illustrates 
this flow. When one of the numbers of the 
computer is dialed on an audio terminal,, 
this terminal is connected to the computer 
if the corresponding audio line is enabled. 

The input message is entered via the 
audio terminal. 
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Figure 23. £udic Message Flow 

















































The following are to explain the seven 
steps shown in figure 23. 


Step 1: The input message passes through 
an audio response unit (IBM 7770 or 7772) 
and the multiplexer channel, and is stored 
into an input buffer. 

The user defines the sizes of his input 
and address chain buffers as parameters cf 
the DTFQT macro instruction required for 
the communication line group. Thus, the 
corresponding buffer areas are reserved for 
each line of the line group. 


Step 2: When the input buffer has been 
filled with the input message, an audio 
line procedure specification (IBS) performs 
user-selected functions such as message 
repetition, cede conversion, logging with 
or without time-received information, and 
input message checking. Then, the IPS 
routes the input message to the MS-process 
queue. This routing is possible if a DTP 
table has been defined for the MS-process 
queue and opened by the message processing 
program; if net, the routing is deferred to 
the opening of the message processing 
program. 

If the audio line group is in 
information mode, there is neither input 
message nor IPS; an interrupt signals the 
connection on line cf the calling terminal 
which receives an invariable audio answer. 
Figure 5 does net illustrate this case. 


Step 3; Whenever the message processing 
program issues a GET macro instruction, 

QTAM transfers the message from the 
MS-process queue tc a user-specified work 
area in the message processing program. 

The length of the audio input message is 
placed in the first two bytes of this work 
area. Then, the message processing program 
processes the input message as required by 
the user's application. 


Step 4s When the message processing 
program issues a PUT macro instruction, 

QTAM transfers the address chain from the 
user-specified work area to an address 
chain buffer. The user must specify the 
length of this address chain in the first 
two bytes of the work area, define and open 
in the message processing program a DTF 
table for the audio output queue to which 
the address chain is to be routed. 


For the 7770 lines, message flow 
proceeds to step 7 since steps 5 and 6 only 
concern the 7772 lines. 


Step 5: If the audio line transmits DCV 
words permanently kept in main storage,, 
message flow bypasses step 5 and proceeds 
to step 6. If the audio line transmits DCV 
words dynamically retrieved from DASD, QTAM 
obtains a DCV buffer from a DCV buffer pool 
defined by the user. 


Step 6: Each address in the address chain 
is analyzed to determine where a DCV word 
is to be fetched. If this DCV word is 
permanently kept in main storage, message 
flow proceeds directly to step 7. If not, 
the word is fetched from the 7772 DCV 
vocabulary file and loaded in the DCV 
buffer allocated to the line. Then, 
message flow proceeds to step 7. 


Step 7: For the 7770 lines, the address 
chain enables the 7770 audio response unit 
to produce the audio answer. Message flow 
then returns to step 1. 

For the 7772 lines* the DCV word is sent 
to the calling terminal. If this DCV word 
is the last word of the message, message 
flow returns to step 1. If not* the return 
is to step 6. 
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TELECOMMUNICATIONS APPLICATIONS (AUDIO) 


A telecommunications system operating 
under DCS/QTAM. can fce designed for a wide 
variety of applications including message 
switching, collecting data, standard audio 
answering, processing collected data, and 
inquiry processing. The audic applications 
are described here briefly. 


MESSAGE CONTROL APPLICATIONS 


Cne application fcr a message control 
program is to standard audic answering,, 
which is only applicable to audio lines 
working in information mode. 

When an audic terminal is connected to 
the CPU on a line working in information 
mode, there is nc input message, but the 
connection itself represents an inquiry 
which requires an invariable audio answer. 
Therefore, the sending of this audio answer 
can be entirely accomplished within the 
message control program, but a message 
processing pregram must be loaded and 
initiated to terminate.the execution of the 
message control pregram. 


MESSAGE PROCESSING APPLICATIONS 


Among a variety of message processing 
applications is that of inquiry processing. 

An inquiry application involves 
receiving messages from terminals 
(performed by the message control program), 
processing the data contained in the 
messages (performed by the message 
processing program), and sending replies to 
the originating terminals (message control 
program). 


The routines called by the message 
processing program to process the messages 
need not reside in main storage. For 
example, in an inquiry processing 
application that requires processing of 
many different types of inquiries,, it may 
not be economical to have all of the 
required processing routines in main 
storage. The message processing program 
can contain an analysis routine that 
determines the type of the message and 
loads the routine required to process it 
from the core image library (via a FETCH or 
LOAD macro instruction). The routines 
fetched dynamically in this manner must 
have previously been linkage-edited onto 
the core image library at a specified 
address in an available area in the 
partition in which the message processing 
program is executing. 


An optional feature of the inquiry 
application is operation in a 
conversational mode. 

When an audio line is in conversational 
mode, the connection is maintained by the 
message control program during the 
successive inquiry/audio answer series. 

The end of a communication is notified 
either by an inquiry expressed by one EOT 
character or by no inquiry (timeout). 
Conversational mode is specified by a 
keyword operand of the DTFQT macro 
instruction associated with the audio 
communication line group. The input 
messages are routed by the audio LPS of the 
message control program to the MS process 
queue of the message processing program, if 
this program has been loaded and initiated. 
When the message processing program is not 
initiated, the input messages are queued in 
a waiting chain. In both cases,, the ARU 
operand must be specified in the PROCESS 
macro instruction associated with this 
message processing program. 
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MESSAGE CONTROL PBCQBAM (AUDIC IINES) 


In every telecommunications systeir using 
QTAM, there must be cne message control 
program* The message control program must 
be executed in the foreground 1 partition 
of the Disk Operating System. With 
multitasking, the message control program 
must he executed as the highest priority 
task in the fcregrcund-one partition. 

For audio lines, message control 
includes those functions that: 

1. Control the flow of the audio messages 
between the computer and remote 
terminals. 

2. Prepare the input messages for pro¬ 
cessing and route them to their appro¬ 
priate message processing program. 

3. Prepare the IEM 7772 output messages 
from the user's output messages and 
send them tc the calling terminal. 

4. Provide the user with statistical in¬ 
formation relating to message traffic. 

5. Provide the user with a copy of 
messages received from audio 
terminals. 

The message control program includes 
both audio communication line QTAM routines 
and audio message handling QTAM routines. 
Input messages coming from audio terminals 
are translated into ABU code by the audio 
response unit before arriving at the 
computer. A facility is provided to 
convert this ABU code into EBCDIC 
representation tc simplify message 
analysis. Such a conversion is not 
required for incoming messages from an IEM 
3944 Dial Terminal attached tc an IEM 7772 
ABU with Dial Terminal feature, which are 
already in EBCDIC representation. 

The input messages are normally sent to 
the MS process queue of the corresponding 
message processing program on a 
first-in-first-cut basis. 

Tc construct his message control 
program, the user must select, place into 
order, and assemble macro instructions 
provided by QTAM. There are four major 
sections in the message control program and 
each can be wholly defined by QTAM macro 
instructions. The fcur major sections and 
the order in which they will be discussed 
are: 

1. File definition. 


2. Control information. 

3. File initialization and activation,. 

4. Line procedure specification. 

File definition and control information 
macro instructions generate the tables,, 
lists, and buffer areas needed in the 
system. Initialization and activation 
macro instructions ready the system for 
operation. 

For audio lines, the LPS section is a 
minor part of the message control program 
which concerns only the audio input 
messages. It is here that the user 
specifies the LPS macro instructions 
establishing the linkage to QTAM routines 
that perform the message code translating,, 
message repetition, error checking, 
logging, and routing functions. 

The information specified in the file 
definition and control information sections 
is also used by the LPS routines in 
performing their functions. There must be 
one LPS for each communication line group 
that requires different message handling 
functions. 

QTAM provides DSECTs (see Figure 24) 
that enable the user to refer symbolically 
to the various fields in the tables and 
control blocks used by QTAM. Two,, three, 
or four such DSECTs are automatically 
generated in the message control program: 

1. Terminal table entry DSECT (includes 
names assigned to an optional subfield 
by the user in OPTION macro 
instructions). 

2. Audio line control block DSECT. 

Note : Two DSECTs are generated when 
processing audio messages. Four DSECTs are 
generated when processing audio and 
nonaudio messages. 

If any other DSECT listed in Figure 24 
is desired in the message control program,, 
it can be included at assembly time by 
including a COPY statement with the name in 
the specify column of Figure 24 in the 
operand field. If any DSECT is required in 
a message processing program, it can be 
included in the same manner (none of the 
DSECTs are automatically generated in a 
message processing program). It should be 
noted that all QTAM DSECT names have the 
four-character prefix, IJLQ ; therefore,, 
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theuser should refrain from using names 
beginning with these four characters. 


Table or 
Control Block 


ESECT Name 


Specify 
(for COPY) 


Teririnal Table 
Entry 


IJLQTBLO 


IJLQTBLD 


7772 DCV 
Buffer 


IJIQBABO 


IJLQEABD 


Audic Line 
Control Block 


IJLQLAEO 


IJLQLABD 


Queue Control 
Block 


IJLQQCEO 


IJLQQCBD 


j DTF Table j IJLQDTFO | IJLQDTFD j 

L- X _-L_J 


Figure 24. QTAE ESECTS 


FILE EEFINI1ICN 


A file definition macro instruction must 
be specified for each file referred tc by 
the message ccntrcl program. Fcur types of 
files are normally used for audio or 
combined systems: 

• Communication line group files. 

• Direct access checkpoint records file. 

• Message leg files. 

• 7772 ECV vocabulary file. 


COMMUNICATION LINE GRCOP FILES 


A communication line group file consists 
of messages transmitted via communication 
lines, cr between the computer and a 
lccally attached IEM 2260-2848 Eisplay 
complex. One or more files of this type 
are required. The user must specify one 
DTFQT macro instruction to define a ETF 
table fer each line group in the system. 

For audio lines, a line group can 
consist of one tc thirty-one 7770 or of one 
to eight 7772 audio lines with the 
following common characteristics: 

• Association with the same functional 
type of audic terminals (for example, 
all the lines connect IEM 1001s and 
1092s to the system; or* when an IBM 
1112 is used, all the lines connect IBM 
3944s to the system). 


• Use of the same audio response unit 
(IBM 7770 or 7772). 

• Use of the same message processing 
program* if any. 

• Use of the same operating mode 
(information* inquiry* or 
conversation). 

• Use of the same length for input 
buffers. 

• Use of the same length for address 
chain buffers. 

• Use of the same invariable audio answer 
when the line group is working in 
information mode (in this case,, the 
address chain and input buffers are not 
required). 

• Use of the same 7772 DCV buffer pool*, 
if any„ 

• Use of the same Audio LPS. 

One additional requirement is that 
no line within the line group can be 
defined as a part of another line group. 


MESSAGE LOG FILE 


A message log file consists of messages 
that are stored and maintained sequentially 
on secondary storage for accounting 
purposes. A message log can be produced as 
a byproduct of normal message handling. 

The appropriate DTFxx macro instruction 
must be specified for each message log 
required by the user. The DTFxx used 
depends on the secondary storage device 
employed. Magnetic tape (DTFMT) is the 
storage medium generally used. (For a 
detailed discussion of the appropriate 
DTFxx macro instruction, refer to the 
Supervisor and Inpqt/Output Macros 
publication listed in the Preface .) The 
QTAM message control program employs 
logical IOCS to record the messages on the 
log. 


7772 DCV VOCABULARY FILE 


One 7772 DCV vocabulary file is required 
by all the 7772 Audio Response Units. This 
vocabulary is made up of all the DCV words* 
in any language* previously loaded on the 
IBM 2311 Disk Storage Drive used (for 
detailed information* refer to the 
Vocabulary File Utility Program for the IBM 
7772 ftudio Response Units publication 
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listed in the Preface ). The user must 
specify one DTFQT macro instruction to 
define a DTF table for this DCV vocabulary 
f ile,. 


FILE DEFINITION MACBC INSTRUCTIONS 


DTFQT Macro Instruction 


One DTFQT iracrc instruction irust be 
specified for the E£SD message queues file, 
the 7772 DCV vocabulary file, and for each 
communication line group file* If the 
Checkpoint/Restart feature is desired,, a 
DTFQT iracro instruction must be provided 
for the DASD checkpoint records file. At 
assembly time, DTFQT causes the allocation 
of main storage for a DTF table. 

Parameters based cn the keyword operands 
specified in the macro instruction are 
included in the DTF table. 


| Name]Operation|Operand | 

K-*-4—--—— 

| dtf ]DTFQT |keyword operands | 


dtf 

Is the name of the macro instruction. 
It is also the name of the DTF table 
generated by the expansion of the 
macro instruction. The name is 
specified by from one to seven 
nonblank characters. The eighth byte 
of the name field is used by QTAM to 
indicate a 2311 or 2314 direct access 
device. 

keyword operands 

Are the operands that can be included. 
The operands for each type of file are 
described in Figures 25 and 26. 
Operands for the message log files and 
checkpoint records that may be used in 
combined applications are described in 
figures 6 and 7. 
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I Keyword Operand 

^- 

TYPE = AV 




j Value Description 
AV 

Identifies the file organization as that of the 7772 DCV 
vocabulary on an IEM 2311 or 2314. 


DEVAEDR = SYSnnn 


SYSnnn 

If multiple volumes are used, only the symbolic unit for the 
first volume is specified. Actual units and channels are 
assigned to the file at job execution with appropriate ASSGN 
statements. The file is expanded to accomodate up to 16 
extents. 


r SEPA SM = YES~1 
1 SEPASM = NC J 


YES 


NO 


Specifies that this DTFQT will be assembled separately from 
the rest cf the user*s code. 

Specifies that this DTFQT will be assembled with the user"s 
code. NO is assumed if this operand is omitted or illegal* 


"VJCRETEL = YES'] 
ftCRETBI = NO J 


YES 


NO 


+~ 


Specifies that the user wishes to keep permanently some 7772 
DCV wcrds in main storage* 

Specifies there are no 7772 DCV words permanently kept in main 
storage. NC is assumed if this operand is omitted. 

-1 


["[EllFPI = 
L(fcUfpCCl 1 „ 


...)]] 


h- 

(ECOAD = relexp] 


tufpooli 

Specifies via a sublist the symbolic names of the DCV buffer 
pools used by the 7772 line groups. A DCV buffer pool is 
required by a 7772 line group when messages sent over its 
lines are made up cf DCV words dynamically retrieved from an 
IBM 2311 or 2314. 

The DCV buffer pcol name must be identical to the name 
specified in the name field of the BUFARU macro instruction 
used to define the ECV buffers. This operand is omitted when 
no ECV words are retrieved from the IBM 2311 or 2314: in this 
case, the foCRDTEI operand must include YES. 

relexp 

Is the name of the instruction starting a user-written section 
of code that closes all files opened in the message control 
program and performs other termination functions. Refer to 
the section,. Deactivating the Telecommunications System ,, for a 
discussion of the functions required in this user-*written 
section of code. 

Note : This operand will be omitted if it has already been 

specified in a DTFQT macro instruction for DASD message 
queues. 


Figure 25. Keyword Operands for the 7772 DCV Vocabulary DTFQT Macro Instruction 
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| Keyword Operand 

I-- 

I TYPE=LG 


j Value Description 
| IG 

| Identifies the file organization as that of a communication 
j line group. 


[CIFS-lpsnaire] 


LINELST- 
(nnn-integer,., 


SEPASM=YES 
SEPASK=NC 


TYPEFLE= 


CMBND 


output 


s (ino\ 

( 7772 ) 


(EUFIN=absexp] 


lpsname 

Is the name of the line procedure specification (LPS) section 
for this audio line group* This name must be identical to the 
name specified in the name field of the LPSTART macro 
instruction that begins the LPS section for this line group* 

This operand will be omitted for an audio line group 
working in information mode. 


Specifies via a sublist the correspondence between symbolic 
unit (SYSnnn) and relative line number. In the sublist*, the 
user codes one 3-digit number for each line in the line group. 
The 3-digit number is interpreted as the •nnn* of SYSnnn. The 
order of ceding the 3-digit numbers determines which symbolic 
units are associated with the individual lines in the line 
group. As many as thirty^one 3-digit numbers from 000-244 may 
be coded in the sublist* 

Example : IINELST=(005,010*007). This results in associating: 

SYS005 with relative line number 1* 

SYS010 with relative line number 2* 

SYS007 with relative line number 3* 
in a line group constituted by three lines. 


Specifies that this DTFQT is to be assembled separately from 
the rest of the user's code. 


Specifies that this DTFQT is to be assembled with the rest of 
the user's code. 


CMEND 

Indicates that the audio line group is to be used for both 
input and output operations. (Assumed, if necessary, when the 
line group is not working in information mode.) 

OUTPUT 

Indicates that the audio line group is to be used for output 
operations. (Assumed, if necessary, when the line group is 
working in information mode.) 


7770 or 7772 

Defines the type of audio response unit (7770 or 7772) 
associated with the audio line group. 


absexp 

Is the length in bytes of each input buffer*, which must not 
exceed 255 bytes. This operand will be omitted when the audio 
line group is working in information mode. 
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| Keyword Operand 

H- 

I CMOEE=INF“ 

| CNCEE-ICR 
| CNCEE=ICW 
| CMOEE=CVR 

I Lceoee=cvw 


j Value rescription 

+“■ - * - " ------ 

j INF 

j Indicates that the audio line group will be used in 
information mode. 


Indicates that the audio line group will be used in inquiry 
mode with initial read operation. 


Indicates that the audio line group will be used in inquiry 
mode with initial write operation. 


Indicates that the audio line group will be used in 
conversation mode with initial read operation*. 


Indicates that the audio line group will be used in 
conversation mode with initial write operation. 

Note: 

If this keyword operand is omitted, IQR is assumed. 


[EUFAC=absexp] 


absexp 

Is the length in bytes of each address chain buffer,,, which 
must not exceed 255 bytes. This operand will be omitted when 
the audio line group is working in information mode,. 


fECVEUF=relexp] 
1 DCVEEF=NO 


(only applicable 
the 7772 ARE*s) 


relexp 

Is the name of the ECV buffer pool specified in the name field 
of the BUFARU macro instruction. NO is assumed if this 
operand is emitted. 


[PRCCESS=relexp] 


relexp 

Is the name specified in the name field of the PROCESS macro 
instruction used to refer to the message processing program 
that will process the input messages received from the lines 
of this line group. This operand will be omitted if the audio 
line group is working in information mode. 


[PUTAC=relexp] 


relexp 

Is the name or the absolute address of the address chain 
representing an invariable audio output message. This type of 
message is required for a line group working in information 
mode, or in inquiry or conversation mode with initial write 
operation. The user must define this address chain in the 
message control program, and place its length in its first two 
bytes. This length must not exceed 255 bytes. Refer to IBM 
System/360 Eisk Operating System,, QTAM Message Program 
Services , Form C3Q-5003, for complete specifications of audio 
address chains. 


LCGTIME=¥ES 

LCGTINE=NG 


Specifies that the input messages to be logged must contain a 
time-cf-^day indication. 

Specifies that the messages to be logged must not contain a 
time-cf-day indication. 

Note ; If the keyword operand is omitted or illegal,, NO is 
assumed. 


Figure 26. Keyword Operands for the Audio Communication Line Group DTFQT Macro 
instruction (Part 2 of 3) 
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j Keyword Operand 

t- 

| t£OJAD=relexp] 

I 

| (only applicable tc 
j the 7770 Allies, 
j when stand-alone) 


j Value Description 


relexp 

Is the name' of the instruction starting a user-written section 
of code that closes all files opened in the message control 
program and performs other termination functions. Refer to the 
section. Deactivating the Telecommunications System * for a 
discussion of the functions required in this user-written 
section of code. 

Note: When the 7770 ARU's are stand-alone, there is neither 
DASD message queue file nor 7772 DCV vocabulary file, and this 
operand must be specified in the DTFQT macro instruction of 
each 7770 line group file. 


THRESH=(absexp*, j 
atsexp a , afcsexp 3 , j 
absexp ) j 
THRESH-(255,25 5 ,5,5) 


Provides the threshold values to be used 
in determining excessive number of errors 
(both temporary and permanent) for a 
specified number cf transmissions for each 
-line of this line group. 

absexp* 

Is the threshold value for the number of transmissions (must 
be frcm 1 to 255 inclusive). If the number of transmissions 
on any line in this line group reaches this threshold before 
any of the error counters reach their thresholds, the four 
threshold counters for this line are added to the four 
cumulative counters for this line, and the threshold counters 
are reset. 

absexp 2 

Is the threshold value for the number of hang^up operations 
(must be frcm 1 to 255 inclusive). If the number of hang-up 
operations on any line in this line group reaches this 
threshold before the number of transmissions reaches its 
threshold value, a message is provided (to the 1052 system 
console or the telecommunication system control terminal if 
the CPCTL macro instruction is included), the four threshold 
counters for this line are added to the four cumulative 
counters for this line, and the threshold counters are reset. 

absexp 3 

Is the threshold value for the number of data checks on read 
operations (must be from 1 to 255 inclusive). Same action is 
taken as in absexp 2 - 

absexp 

Is the threshold value for the number of data checks on write 
operations (must be from 1 to 255 inclusive)• Same action is 
taken as absexp a . 

If this operand is emitted, the threshold values 255 w 255 w 5 W 
5 are assumed. 


Figure 26. Keyword Operands for the Audio Communication Line Group DTFQT Macro 
Instruction (Part 3 of 3) 
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Examples : 


1. A ETFQT iracrc instruction that defines the DTF table representing an audio 
communication line group: 


r-r-r- - -—- 

| Name | Operation | Operand 

^-+—-+- 

j ARU1 | DTFQT j TYPE=LG,CLPS=ARULPS, FFCCESS=CPU ff LINELST=(Oil* 012 )„ 

j j j TYPEFLE=CMBND,,CU=7772,CMODE=CVR„BUFIN=40„BUFAC=100 

L_-L-JL_ 


Col. 72 | 

-1 

* I 


2, A DTFQT macro instruction that defines the DTF table representing a 7772 DCV 
vocabulary file: 


r~- t-t - - -n 

| Name | Operation | Operand | 

V -+-+-- i 

j AUDIC | DTFQT | TY PE=AV ,EEVADER= S Y S 010 , WORDTBL= YES j 

l-JL-JL--J 


CCNTPCI INFORMATION 


In constructing the audio section cf the 
message control program for his 
telecommunications system, the user must 
provide certain control information* This 
data includes: 


* A terminal table that contains all of 
the terminal cedes as we 11 as complete 
information atcut the terminals 
connected tc the system. These 
terminals include the message 
processing programs* which are the only 
terminals to re specified fer an audio 
application. 


® An audio line table that contains 
information about audio communication 
lines. 


® A 7772 word table that contains 
information atcut the DCV werds 
permanently kept in main storage. 

• 7772 DCV buffer specifications that 
define the size and the maximum number 
of DCV buffers constituting a DCV 
buffer peel. 

The IBM-prcvided logic that supports the 
message control program uses this control 
information in performing the message 
handling functions specified by the user. 
Macro instructions are provided that allow 
the user to define the terminal table, the 
audio line table, the 7772 word table* 
polling lists, and buffer areas in 
accordance with the requirements of his 
application. 


TERMINAL TABLE 


A telecommunications system using QTAM 
requires one terminal table. For audio 
lines,, the information required in the 
terminal table consists of a table control 
field defining the length of the table,, and 
blocks of information (process program 
entries) about each message processing 
program that processes the audio messages. 
This field is described in Appendix A and 
in the following paragraphs. 

For audio lines, the size,, structure,, 
and contents of the terminal table are 
based on information provided by the user 
through the TERMTEL* and PROCESS macro 
instructions. 

« TERMTBL is specified once and defines 
the limits of the table. 

• Process creates a process program 
entry. 


Process Program Entry 


A process program entry is required for 
each message processing program whatever 
the type of application: 

• Audio application 

• Combined application 

Audio Applications : The terminal table 
must include one process program entry for 
each MS process queue. Tihe input messages 
are directly routed to the MS process queue 
associated with the message processing 
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program, after it has been initiated (if 
not* they are queued cn a waiting chain). 

The structure cf a process prograir entry 
is the following: 


Field 

Eescription 

IJLCTSZE 

Size of the entry. 

IJLQTQAD 

Pointer to the address cf the 
queue control block for the MS 
process queue. 

IJLCTTIE 

Name assigned to the process 
program entry. 

IJLCTWCB 

Address of the first element 
in the waiting chain. 


Combined Application s: The same message 
processing program can process audio and 
ncnaudic messages. In this case, only one 
process program entry must be included in 
the terminal table. The elements 
constituting this entry are: 

IJLCTSZE 

IJLQTQAD 

IJLCTTIE 

IJLQTSCT 

IJLCTSTA 

IJLQTfcCH 

For the three types of application, the 
PROCESS macro instruction provides the 
initial contents for all fields in the 
process program entry. Detailed 
information on this entry can be found in 
Appendix A. 


Terminal Table (TERMTBL) Macro Instruction 


The TERMTBL iracrc instruction causes a 
table control field to be created for the 
terminal table and defines the length of 
the table. Depending upon the type of 
application, the expansion of this macro 
instruction also generates up tc four 
DSECTs that enable the user's symbolic 
references to communicate with those of 
CTAM• Cne DSECT provides names for the 
fields in each terminal table entry, and 
another supplies names for the fields in an 
audio line control block (ALCE). QTAM 
maintains an ICE for each communication 
line,, and an ALCE for each audio 
communication line attached tc the system. 
Each ALCB contains control information 
about its associated line. The fourth 
DSECT provides names for the buffer prefix. 

Cne TERMTBL macro instruction is 
required, and it must precede all other 
macro instructions used in creating the 
terminal table. 


|Name J Operation|Operand j 

|TERMTBL |entry*[n] 


i 


j[„OPCTL=chars] 


j t j, CPINTV=integer ] 

\r 


„ CONF 


4 


ARU \ 
MIXED/ 






entry 

Is the name of the last entry in the 
terminal table. 

The entry name can be TERMTBL itself 
for compatibility when the audio 
response units are stand-alone and 
working in information mode only (no 
message processing program). In this 
case, n can be omitted. 


Is the number of characters in the 
longest terminal name. This operand 
is not necessary if the lengths of all 
terminal names are the same. 


OPCTL 

The name of the CPCTL macro 
instruction in the LPS. This operand 
specifies that error messages are to 
be sent to the operator control 
terminal specified in the OPCTL macro 
instruction, rather than to the 1052 
system console. When this operand is 
specified, error messages that 
originate from errors on the operator 
control terminal receiving error 
messages are printed on the 1052 
system console. This operand must not 
be specified unless che OPCTL macro 
instruction is specified in the LPS. 
When this operand is not specified* 
the error messages continue to be sent 
to the 1052 system console. 

CPINTV 

The number of 15-second intervals 
between checkpoints. It must be an 
integer from i (15 seconds) to 60 (15 
minutes) inclusive. 


CONF 

CONF=MIXED must be coded if there are 
both audio and nonaudio lines in the 
system. 

CONF=ARU must be coded if there are 
only audio lines in the system. 

This operand may not be omitted for 
audio or combined systems. 

Note: The name field is ignored. 
IJLQTTBL is the name generated for 
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the terminal table by the macro 
instruction expansion* 


Terminal Table Process (PROCESS) Macro 
Instruction 

The PROCESS macro instruction causes the 
name and associated information of a EASE 
process queue (ccmfcined applications) or of 
an NS process queue (audio applications) to 
be included as an entry in the terminal 
table* The entry produced is a process 
program entry* It differs from other 
terminal table entries in that it does net 
have an optional area or device access 
area, the IJIQTSIN field is net used, and 
an additional waiting chain field is 
required by the audic response units. A 
message processing program, like a 
terminal, can be a destination for a 
message* However, unlike a terminal, the 
processing program is not associated with a 
communication line and does net need 
addressing and polling characters. 

One PROCESS macro instruction must be 
included for each NS process queue that is 
defined by a DTEQT macro instruction in a 
message processing program. 

For nonaudic lines, the EXPEDITE operand 
permits the user to speed the processing of 
messages by the message processing program 
associated with the process program entry. 
This function is valuable for an applica¬ 
tion requiring immediate transmission of 
data tc a message processing pregram. A 
combination of the EXPEDITE function and 
conversational mode (subsequently dis¬ 
cussed) provides the most rapid response to 
an inquiry. 

For audio lines, the ARU operand permits 
the user to create an additional field in 
the process program entry (to queue the 
input messages waiting for the N.3 process 
queue chaining). 

r - T - t-1 

|Name |Operation|Operand | 

j.- + - 4 —-- 4 

j symbol|PROCESS j (EXPEDITE)C, ARU3 | 

L-J.- JL - J 

symbol 

Is the name of the process program 
entry in the terminal table. The name 
must be specified, and must be the 
same as the PROCESS keyword operand 
specified in the MS-process queue 
ETFQT macro instruction in a message 
processing program. The name can 
contain from one to eight nonblank 
characters. 

EXPEDITE 

This optional operand (not applicable 


to the audio lines) specifies that 
messages are to be routed directly to 
the message processing program's 
MS-process queue,, bypassing the normal 
intermediate step of placing the 
messages on a DASD-process queue. 
EXPEDITE snould not be specified if 
multisegment messages are expected, 
because segments from different 
messages may be intermixed as they are 
delivered to the queues. This 
restriction does not apply for 
multisegment messages received from an 
IBM 2260 Local. 

ARU 

This operand must be specified when 
the process program entry is defined 
for a message processing program 
working on audio lines. 

Note : If this operand is omitted,, the 

process program entry is considered as 
defined for nonaudio lines. 


AUDIO LINE TABLE 


A telecommunications system with audio 
lines requires one audio line table. Two 
control information macro instructions 
produce, at assembly time,, an audio line 
table tailored to the audio configuration 
desired by the user. The audio line table 
is made up of a table control field,, which 
defines the length of the table,, and of 
blocks of appropriate information for each 
audio line; these blocks are called audio 
line table entries, or line entries. 

The size, structure, and contents of the 
audio line table are based on information 
provided by the user through two macro 
instructions,, LINETBL and LINE. LINETBL is 
specified once, to define the limits of the 
table. LINE creates a line entry in the 
line table. 

Each line entry is made up of four 
fields, whose contents are as follows: 

• Size of the line entry 

• Address of the DTF table for the audio 
line group in which the line is 
included 

• Relative line number of the line within 
the audio line group 

• Name assigned to the audio line by the 
user. This field is present in each 
line entry; its length is the same in 
each entry,, and is based on information 
provided by the user. If the number of 
characters in each line name varies,, 
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the number of bytes in this field is 
equivalent to the number cf characters 
in the longest line name. If the 
number of characters in each line name 
does not vary, the number of bytes in 
this field is equivalent to the fixed 
number of characters. In any case, 
this field can be a maximum of eight 
bytes. 


Audio line Table (IIKETBL) Macrc 
Instruction 


The IINETBI macro instruction creates 
the table control field of the line table, 
and defines the length cf the table. This 
instruction roust precede all the LINE macro 
instructions used tc create the line table. 

—-—r~"— f— -T 

(Name |Operation(Operand | 

H- 4 -—-+--4 

I |IINETBI j entry [ ,nl | 

L—™—.1— ---,-j 

entry 

Is the name cf the last entry in the 

line table. 

n 

Is the number of characters in the 
longest line name. This operand is 
not necessary when all line names have 
the same length. 

Note: The name field is ignored. 

IJLQLTBL is the name generated for the 
line table by the expansion of the 
macro instruction. 


Audio Line Table Entry (LINE) Macro 
Instruction 


The LINE macro instruction includes a 
line name and its associated line 
information as an entry in the line table. 
One LINE macro instruction must be 
specified for each audio line and all LINE 
macro instructions must be grouped 
together. 

r -- T -“““T“-*-1 

(Name |Operation(Operand | 

H-+——-4~-—--I 

|symbol|LINE |filename,rln | 

i— x — jl„„ ___J 

symbol 

Is the line name, made up cf one to 
eight nonblank characters; it must be 
specified. This name roust also be 
present in the source or destination 


field defined by the user, when a GET 
or PUT macro instruction concerns a 
message using the audio line. 

filename 

Is the name of the DTF table for the 
audio line group in which the line is 
included. 

rln 

Is the relative line number of the 
line within the audio line group. 


Example Audio Line Table Definition 


Figure 27 shows the coding sequence to 
be used to create an audio line table. The 
audio terminals are IBM 1001*s attached to 
an IBM 7770 ARU by four switched audio 
communication lines operating in inquiry 
mode. 


r - T - T -T--- 

| No.| Name | Operation | Operand | 

| 1 | i LINETBL | LONDON,, 6 | 

| 2 | PARIS J LINE | LGONE*1 | 

*-4-+-+- 4 

| 3 | ROMA * LINE j LGONE„2 | 

| 4 | BERLIN ] LINE | LGTWO^l | 

J 5 | LONDON | LINE | LGTWO„ 2 | 

l-JL- X -J-—-J 


Figure 27. Example of Coding Sequence Used 
to Create an Audio Line Table 

Instruction 1 (LINgTQL) : Identifies the 
last entry in the audio line table. The 
second operand specifies the length of the 
longest line name. 

Instructions 2 through 5 (LINE) : Defines 
the line entries for the lines in two audio 
line groups. The first operand of each 
LINE macro instruction specifies the name 
of the DTF table for the audio line group 
in which the line is included. In this 
case, there are two audio line groups and 
two DTF tables. The second operand of each 
LINE macro instruction is the relative line 
number of the line within its audio line 
group. In the audio line group associated 
with the DTF table named LGONE,, PARIS and 
ROMA audio lines have the line numbers 1 
and 2„ respectively. These relative line 
numbers correspond to those given to the 
ALCB * s generated in the expansion of the 
DTFQT macro instruction with LINELST 
operand. The user assigns each audio li.ie 
at system generation (this assignment can 
be modified by an ASSGN statement),. 
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7772 WCRD TABLE 


A telecommunications systeir with at 
least one IBM 7772 ARE using ECV words 
permanently kept in main storage requires 
one 7772 word tahle. Two control 
information macro instructions produce, at 
assembly time, a 7772 word tatle tailored 
to the DCV words specified by the user. 

The 7772 word tatle is made up cf a table 
control field, which defines the length of 
the tahle, and of blocks of information for 
each ECV word periranently kept in main 
storage. Each blcck is called a 7772 word 
table entry, or word entry. 


The size* structure, and contents of the 
word table are based on information 
provided by the user through two macro 
instructions, WCRETEL and WORE. WORETBL is 
specified once, tc define the limits of the 
table. WORD creates a word entry in the 
word tahle. The word cable must contain a 
word entry for each ECV word required in 
main storage. 

Each word entry is made up of four 
fields, whose contents are as fellows: 

• Disk address cf the DCV word 
representation: this address is 
expressed in the form TTR, where TT is 
the track number and R the record 
number. 

• Size of the word entry 

• Length of the DCV word representation 

• DCV word field: an area in which the 
DCV word representation is read from 
the 7772 DCV vocabulary file. 


7772 Word Table (WCRETBL) Macro Instruction 


The WCRDTEL macro instruction creates 
the table control field of the 7772 word 
table, and defines the length of this 
table. When the WCRETEL macro instruction 
is specified, it must precede all the WORD 
macro instructions used tc create the word 
table. 

r ---1 

(Name (Operation|Operand | 

k - 4 - 4 - i 

I jWCRDTEL jentry j 

l-JL- Jl -J 

entry 

Is the name cf the last entry in the 
word tahle. 


Note : The name field is ignored. 
IJLQWTBL is the name generated for the 
word table by the expansion of the 
macro instruction. 


7772 Word Table Entry (WORD) Macro 
Instruction 


The WORD macro instruction creates an 
entry in the word table which requires a 
DCV word representation to be included in 
the DCV word field of this entry. The DCV 
word representation is extracted from the 
7772 DCV vocabulary file, and read in the 
DCV word field at open time of this file. 
One WORD macro instruction must be 
specified by the user for each DCV word 
required in main storage. All WORD macro 
instructions must be grouped together. 


f-T-T-*— -—— -~~1 

(Name (Operation)Operand | 

| |(symbol]|WORD |diskaddr-X f hex* v Igth | 

l __i___ x _______.J 


symbol 

Is the word name, consisting of one to 
eight nonblank characters. It must be 
specified for the last WORD macro 
instruction used to create the word 
table. 


diskaddr 

Is the disk address of the DCV word 
representation. It must be written in 
hexadecimal notation* 


length 

Is the length of the DCV word 

representation. 

Note : The values of "diskaddr” and 

"length” are indicated in the listing of 
the DCV operative vocabulary file, which 
results from the execution of the OVF list 
function of the vocabulary file utility 
program (see Vocabulary File Utility 
Program for the IBM 7772 Audio Response 
Units publication listed in the Preface ). 


Example 7772 Word Table Definition 


Figure 28 shows the coding sequence to 
be used to create a 7772 word table. 
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r - T - T -T- 

| No.| Name | Operation | Operand | 

K-+-4~-4-^ 

| 1 j j WCBETBL I WORD 3 j 

»■- 4 -- + - + -—H 

j 2 j WGRD1 j WCBD j X f 004801*, 240 j 

k -4-4-4- i 

j 3 | WORD2 | WORD | X*005306*,384j 

t-4- 4 -4-1 

j 4 j WCBD3 j WORD j X* 01020E # w 127 j 

L_X_X-X_J 

Figure 28. Example cf Coding Sequence Used 
tc Create a 7772 Word Table 

Instruction 1 (WCBETEL) : Identifies the 
last entry in the word table, used by the 
opening routine of tb i 7772 DCV vocabulary 
file tc load the ECV word representations 
in main storage. 

Instructions 2 through 4 (WORE) : Define 
the wcrd entries fcr three DCV words 
required in main storage. 


AUDIO EUFFEB SPECIFICATION 


An audio application may require three 
types of buffer: 

• Input buffers tc store the input 
messages. 

• Address chain buffers to stcre the 
chains of addresses corresponding to 
the words which constitute the audio 
output messages. 

• Output buffers to store the DCV 
representations cf each word 
dynamically retrieved from the 7772 
vocabulary file, as required by the 
address chain content. 

The input and address chain buffers are 
specified through the keyword operands 
BUFIN and BUFAC of the DTFQT macro 
instruction defined for the audio line 
group. 

When at least cne audio line attached to 
an IBB 7772 ABU uses ECV words dynamically 
retrieved from, the 7772 DCV vocabulary 
file, the user must specify the size and 
number of main storage areas required by 
QTAN fcr output buffering. This 
information is provided through the EUFABU 
macro instruction in the message control 
program • The main storage areas defined 
above form a DCV buffer pool dynamically 
used by CTAM. 

All buffers in a ECV buffer pool have 
the same length. This length must be at 
least equal tc twice the length of the 


longest DCV representation of the words to 
be dynamically retrieved from the 7772 DCV 
vocabulary file. 

The minimum number of buffers in a DCV 
buffer pool is one. The optimum number is 
equal to the number of lines likely to be 
simultaneously used for output transmission 
(refer to the IBM System/360 Component 
Description, IBM 7772 Audio Besponse Unit 
publication listed in the Preface ). The 
number cannot exceed eight (the maximum 
number of lines). 


BUFARU Macro Instruction 


This macro instruction is only 
applicable to the 7772 audio lines. 

A BUFARU macro instruction enables the 
user to define a DCV buffer pool for one or 
several line groups associated with an IBM 
7772 ARU to be specified, when required by 
QTAM for an audio application. 

r - T - T -----1 

(Name |Operation)Operand | 

j.-4-—--- : — --H 

j symbol|BUFARU j n,length j 

L-X- X -.-J 

symbol 

Is the name of the DCV buffer pool. 
This name is always required and must 
appear in the DCVBUF keyword operand 
of the DTFQT macro instructions 
defined for the line groups associated 
with this ARU, when the messages 
transmitted on their lines are made up 
of DCV words to be dynamically 
retrieved from the 7772 DCV vocabulary 
file. 

n 

Is the number of DCV buffers to be 
reserved. 

length 

Is the length, in bytes, of each DCV 
buffer. This length must be equal to 
twice the length of the longest DCV 
word to be retrieved from the 7772 DCV 
vocabulary file. 


FILE INITIALIZATION AND ACTIVATION 


The file initialization and activation 
section of the message control program 
begins with an OPEN macro instruction and 
ends with the ENDREADY macro instruction. 
Within the message control program, this 
section must precede the LPS section. 
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Whenthe instructions in this section have 
been executed,, the system is ready to 
handle message traffic. 

The CPEN macro instruction completes the 
initialization fcr and activation of the 
DASD message queues, 7772 DCV vocabulary, 
communication line group, message log, and 
checkpoint records files. The files used 
by the message ccntrcl program can be 
opened by separate CPEN macro instructions, 
or they can all be opened with cne CPEN. 
However, regardless cf which method is 
used, the user must open the EASD message 
queues file, if any, before any other file 
used by QTAM. If there is no DASD message 
queue file, but there is a 7772 DCV 
vocabulary file, the latter must be opened 
before any other file used by QTAM, and 
always before the communication line group 
files. Opening a communication line group 
file causes all lines in the line group to 
he prepared for operation. The lines are 
activated automatically for message 
transmission. 

The ENEREAEY nacre instruction must be 
the last instruction in the file 
initialization and activation section. 

When ENDREADY has been executed, the system 
is ready to handle message traffic* The 
expansion of this macro instruction causes 
a branch to the IEN-provided logic that 
supports the message control pregram, where 
procurement of the first message is awaited 
(for nenaudio lines, the first message 
procured can be either a message coming in 
from a terminal, cr a message being sent to 
a terminal by a message processing program; 
for audio lines, the awaited message is 
always a message coming in freir an audio 
terminal. When the first message is 
procured, contrcl is returned tc the IPS 
section of the message control program fcr 
handling cf the message. For this reason, 
no executable code may be included between 
ENDREADY and the IPSTART macro instruction 
that begins the IPS section. 

Cnee the IPS is initially entered via 
the expansion of the ENDREADY macro 
instruction, execution in the message 
contrcl program is restricted tc the IPS 
section; that is, the LPS is continually 
reentered tc handle messages entering and, 
except for the audio messages, leaving the 
computer as leng as the message control 
program is active. Deactivation of the 
message contrcl pregram and the 
telecommunications system is accomplished 
by closing the message control program 
files. The section. Deactivating the 
Teleccmmunicaticns System , contains a 
discussion of the procedures necessary to 
terminate the message contrcl program. 

For audio lines, the STARTARD and 
STOPARU macro instructions may be used in 


the initialization and activation section. 
In the user-written routines of the LPS 
section, or in the message processing 
program. 


’Q PEN Macro Instruction 


OPEN is used in the message control 
program to complete the initialization and 
activation of the DASD message queues, 7772 
DCV vocabulary, communication line group, 
message log, and checkpoint records files* 
All these files can be opened separately or 
with one OPEN. However, the user must open 
the DASD message queues file, if any, 
before any other file used by QTAM. If the 
Checkpoint Restart feature is used, the 
DASD checkpoint records file must be opened 
after the DASD message queues file: If 
there is no DASD message queues file, but 
there is a 7772 DCV vocabulary file, this 
file must be opened before any other file 
used by QTAM and always before any 
communication line group file. The user 
specifies, as the operand(s) of the OPEN 
macro instruction, the name(s) of the DTF 
table(s) for the file(s). 

If the DTF table for a 7772 DCV 
vocabulary file is specified, the OPEN 
routine completes the initialization for 
use of all the DCV buffer pools, and loads 
the DCV words required in main storage if a 
7772 word table is present in the message 
control program. 

If the DTF table for a communications 
line group is specified, the OPEN routine 
completes the initialization for all lines 
in the line group and automatically 
activates the lines for message 
transmission. For the audio lines, 
enabling is initiated. If a line does not 
have an active polling list with terminal 
entries, or if TYPEFLE=OUTPUT is specified, 
polling is not initiated. If the OPEN is 
for a switched line group with 
TYPEFLE=INPUT or CMBND, the OPEN routine 
issues commands to enable each access line 
in the line group. 

If the Checkpoint/Restart feature is 
used, the status of audio lines is not 
restored to that of the previous 
checkpoint, since a restart for audio lines 
is the same as an initial program load. 

The formats for the message queues file 
and for the checkpoint records file are 
checked when the particular file is opened. 
If the file is formatted incorrectly, an 
error message is provided, and the job is 
cancelled. 
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If a message leg ETF table is specified, 
initialization is completed for placement 
of messages on the device to be used for 
logging. 


r -- T - ^ 

(Name |Operation]Operand | 

j[symbol]j OPEN | filename,... j 

i— - x _ x ___J 


® If neither DISKFILE nor VOCFILE is 
specified: 


| Name]Operation|Operand | 

H—--—+—-— --- i 

j j OPEN j LNGROUP1,...»LNGROUPN, | 

j j |LOGFILE j 

_ XL _——__________J 


symbol 

Is the name of the macro instruction. 
The name is optional. 

filename 

Specifies the name of the ETF table 
associated with the file being opened. 
Several files may be opened with one 
OPEN by entering their DTF names as 
operands. 

If register notation is used, any 
general register in the range 2 
through 12 may be specified. The 
programmer must load the address in 
the register before issuing the OPEN,. 


Note 1 . Several files may be opened with 
one OPEN. 

Note 2 ; It is permissible to intermix 
register notation and relocatable 
expressions in the same OPEN. For example: 


(Name |Operation|Operand | 

| OPENER|OPEN |DISKFILE, (3)„ (4)„LCG | 

L-Jl- JL _J 


Note (only applicable to audio lines) : 
Assuming the DTF table of the DASD message 
queue file is named EISKFILE, and the DTF 
table of the 7772 DCV vocabulary file is 
named VOCFILE, the opening sequence of all 
the files must be one of the following: 

• If DISKFILE and VOCFILE are specified: 


Name|Operation|Operand 

j. j. 

(OPEN 

1 

1 

|EISKEILE,VOCFILE, 

jIEGRCUP1__,,INGROUPN, 

jLOGFILE 

l 

• If cnly 

VOCFILE is specified: 

T T 

Naire | Operation | Operand 

i j. 

T 

| OPEN 

1 

_J.- 

T 

j VOCFILE ,1NGRCUP1,. . ., 
j LNGRCUPN,LOGFILE 


ENDREADY Macro Instruction 


The file initialization and activation 
section must be ended by an ENDREADY macro 
instruction. ENDREADY is essentially a 
wait-type instruction? the event awaited is 
the procurement of the first message. Only 
one ENDREADY macro instruction can be 
included, and it must be the last in the 
group of file initialization/activation 
instructions. Prior to issuing ENDREADY*, 
the user must ensure that register 13 
contains the address of an 18~word save 
area. ENDREADY saves the user f s registers 
in this area by standard register saving 
conventions. When control returns to the 
user at the address specified in the EOJAD 
keyword operand of the DTFQT for the first 
file opened in the message control program, 
the registers (except for register 14) are 
restored. No operand is required. 


r - T -------- 1 

|Name J Operation|Operand | 

| ]ENDREADY ] | 

L_J__ X _J 


AUDIO LINE PROCEDURE SPECIFICATION 


The procedure followed by a message 
control program in operating upon messages 
being received from or, except for audio 
lines,, sent to terminals is defined by a 
line procedure specification (LPS). An LPS 
is a sequence of IBM-provided statements 
called LPS macro instructions. The user 
must provide an LPS for each communication 
line group in his system. However,, one LPS 
may be used by more than one line group if 
each of the groups requires identical 
message control procedures. For audio 
lines,, the LPS (or Audio LPS) is only 
concerned with audio input messages. 

For audio lines, the purpose of the LPS 
is to define macro-introduced routines 
that: 

1. Examine and process control 

information,, if any, contained in the 
first byte of the input message. 
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2. Perform functions necessary to send 
the input iressage to the message 
processing program. 


Preparing an IPS consists primarily of 
selecting the appropriate IBM-provided 
macro instructions and writing them in a 
particular sequence, according to the 
requirements of the installation and of the 
line group. Considerations such as the 
message header format(s) # the processing 
requirements for various types cf messages 
(if messages having different handling 
requirements are directed to the same LPS), 
the type cf terminal in the line group, and 
whether the IPS is operating on messages 
from switched or ncnswitched lines must be 
carefully analyzed. 


Twc major types cf macro instructions 
are used in the IPS: functional macro 
instructions and delimiter rnacrc 
instructions. In general, the functional 
macro instructions perform the specific 
operations required on messages directed to 
the IPS. Delimiter macro instructions for 
audio lines identify a sequence of 
functional macro instructions. 


COMPONENTS OF THE AUDIO IPS 


The Audio IPS consists of one group of 
macro instructions handling the audio input 
messages. Within this group, the user can 
build different subgroups of coding 
sequence by using an ARUMGTYP macro 
instruction. This macro instruction 
examines the message-type indicator in the 
first byte of the input message, and 
directs this message to the appropriate 
subgroup; the user can include his own 
routines in this subgroup to perform 
special functions in place of or in 
addition to the functions provided by QTAM 
macro instructions. It should also be 
ncted that any user code within the ARU/LPS 
should be re-entrant. An Audio LPS must 
contain at least the LPSTART and POSTARU 
delimiter macro instructions to link the 
Audio IPS with the IEK-provided logic that 
supports the message control pregram. If 
all the audio lines are operating in 
information mode, no Audio IPS is required. 


The following shews the different macro 
instructions which can be included in the 
Audio IPS. The functional rnacrc 
instructions are listed in alphabetical 
order. 


r- T - t- 1 

| Delimiter | Functional ) Remarks | 

i--+-+-1 

| LPSTART | ] required | 

*-+-+- 1 

| | ARUMGTYP ] | 

j I CHECKARU | I 

I j LCGSEG ] j 

| j REPEAT j j 

j j TRANS ] j 

h- + -+-^ 

j POSTARU | j required j 

There are two major types of Audio LPS 
macro instructions: delimiter and 
functional macro instructions. The user is 
cautioned against transferring control 
between macro instructions within the LPS,. 

A user-written branch to a macro 
instruction may require that the user 
perform certain functions (such as register 
saving and restoring) which are normally 
provided by QTAM. Since user-written 
branches are the exception rather than the 
rule, the name fields in the macro 
instruction formats for the audio LPS macro 
instructions (with the exception of 
LPSTART) have been omitted. The user may 
supply a name with an equate statement if a 
name is needed. 


DELIMITER MACRO INSTRUCTIONS (AUDIO LINES) 


Line Procedure Specification Start 
(LPSTART).Macro Instruction 


The LPSTART macro instruction provides 
an initialization procedure for the Audio 
LPS. LPSTART is required and must be the 
first macro instruction in every Audio LPS. 

r -"T- - -T-1 

|Name (Operation (Operand | 

j lpsname j LPSTART j TERM= (termcode ±v/ . . . ) j 
lpsname 

Is the name of the macro instruction 
and is required. It roust be the same 
as lpsname specified in the CLPS 
keyword operand of the DTFQT macro 
instruction for the line group. 

termcode*.... 

The identifying code for the types of 
terminals that utilize this LPS. The 
following values can be included in 
the sublist: 

7770=IBM 7770 audio response units; 
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7772=IBM 7772 audio response units. 


Post audio LPS (PCSTARU) Macro Instruction 


The PCSTARU iracrc instruction identifies 
the end cf the sequence of instructions 
which processes the input messages coming 
in frcro the audio terminals. 

Cne PCSTARU macro instruction is 
required in each Audio IPS, in which it 
must he the last instruction. No operand 
is required. 

r- T --- n 

|Operation| Operand | 

t - 4 - i 

(PCSTARU | I 

L- X ------ 


FUNCTIONAL MACRO INSTRUCTION DESCRIPTIONS 
(AUDIO LINES) 


The functional macro instructions 
available for audio lines perform specific 
functions on input messages. The macro 
instructions and their fuctions are: 

ARUMGTYP -Routes input messages to a 
user-specified sequence cf 
instructions. 

CHECFARU -Checks for errors in message 

reception and, if found* sends 
the user an error message. 

LOGSEG -Maintains logs of input messages 
on an auxiliary storage device 
(and inserts tiroes). 

REPEAT -Checks fcr a request for a 

repetition of the previous audio 
answer. 

TRANS -Translates input messages. 

The following functional macro 
instructions are applicable only to audio 
lines. No other CTAM macro instructions 
may be coded for audio lines. 


ARU Message Type (ARUMGTYP) Macro 
Instruction 


The ARUMGTYP macro instruction 
classifies incoming messages into types 


depending on the processing required. The 
first character of an input message is 
compared with a type character specified in 
the operand of the ARUMGTYP macro 
instruction. If the two characters are the 
same, the user-written instructions placed 
between the ARUMGTYP macro instruction and 
the next ARUMGTYP macro instruction are 
executed. If the two characters are 
different* the user-written instructions 
are not executed. 


The last ARUMGTYP macro instruction in 
the audio LPS is coded with no operand. 

The user-written instructions between this 
ARUMGTYP macro instruction and the POSTARU 
delimiter are executed if the first 
character of the input message is not the 
same as the message-type character operand 
of a previous ARUMGTYP macro instruction. 

If the character is the same* the message 
has already been handled by a previous 
ARUMGTYP macro instruction and the user 
instructions between the final ARUMGTYP and 
the POSTARU macro instructions are not 
executed. 


The ARUMGTYP macro instruction may be 
used as frequently as desired or may be 
omitted. 


r- T -*-—-1 

|Operation| Operand | 

| ARUMGTYP | typchar | 

t- ± ---.-J 


typechar 

Is the message-type character which 
may be any nonblank character. This 
operand must be omitted if the 
ARUMGTYP macro instruction which 
contains it is the last ARUMGTYP macro 
instruction; in this case* the 
following macro instructions or user 
instructions process any input message 
which has not been handled by a 
previous ARUMGTYP macro instruction 
with a nonblank operand. The 
message-type character may be 
specified either as the character 
itself or as the hexadecimal 
representation of the character. The 
framing C or X and quotes must be 
coded. 


Example : An Audio LPS using ARUMGTYP macro 
instruction is shown in figure 30. 
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Name 

T 

|Operation 

-j_ 

T T 

|Operand |Comments 

j _ 

LPSARU 

|LPSTART 

|TERM=(7770)|Delimiter 


-+- 

_ + -+- 


| |TRANS |RCVARU 

I (REPEAT jx'FO' 

|- - + - +- 

| | ARUMGTYP | C' A 1 

I--+-+- 

I I- I 


1 ---+-+- 

| I ARUMGTYP | C * 3' 

K-+-+- 

I 1“ I 

I I I 

I I I 

I I I 

h-+-+- 

| |ARUMGTYP | 

1 I I 

Y -+-+- 


I- 

I 

L 


+ --- 

|POSTARU 
x- 


I 

+ 


|Macro instructions executed 
|for all input messages 

4 - 

|Test for A-type messages 

+- 

|LOGSEG or CHECKARU macro 
|instructions, or user- 
jwritten routines executed 
|for all A-type messages 

4 - 

|Test for B-type messages 

4 - 

|LOGSEG or CHECKARU macro 
I instructions, or user- 
jwritten routines executed 
j for all B~type messages 

4 - 

|Test for all other types of 
j messages 

4 - 

|LOGSEG or CHECKARU macro 
jinstructions, or user- 
jwritten routines executed 
j for all other types of 
j messages 

j Delimiter 

.x_ 


a 

i 


A 

I 

•I 


A 


A 


A 

I 


Figure 29. Use of ARUMGTYP Macro Instructions in an Audio LPS 


Audio Error Message (CHECKARU) Macro 
Instruction 

- —. 7 , — - 

The CHECKARU iracro instructicn sends an 
audio error message to the audio terminal 
on the line, when one of the errors 
specified in the error mask has been found 
in the error byte. 

The user must specify in the CHECKARU 
macro instructicn: 

• The bit configuration of the mask used 
tc test the error byte associated with 
the audio line 

• The symbolic address of the address 
chain representing the user f s error 
message, or the address chain itself 

Each bit in the line error byte is set 
on and takes the value 1 whenever an error 


has been detected. It is set off and takes 
the value 0 after an audio answer has been 
sent on the line to the calling terminal. 
The user can set bits 4 through 7 
(user-reserved bits) by using any 
user-written routine which perforins a check 
specific to the awaited input message (see 
the section Including a User-written 
Routine within the LPS or the Audio LP£>) «, 
Figure 30 summarizes the functions of the 
line error byte. 


The length of the address chain 
representing the user 9 s error message must 
exceed neither 255 bytes nor the length of 
the address chain buffer defined for the 
audio line. Refer to IBM System/360 Disk 
Operating System QTAM Message Processing 
Program Services ,, Form C30-5003,, for a 
complete specification of audio address 
chains. 
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jEit j Function 

L ± ^ J 

Explanation | 

1 T 1 

| 0 | Cverlength 

| j message 

l J. -1 

An audio terminal has attempted to send an incoming message j 
whose length exceeds the length of the input buffer area. | 

r t i 

| 1 | Repeat error 

i i 

L 4 J 

^ -t—-it xr -r -r i| 

A repeat code is the first character in an input message | 

which is the first message in a conversation. | 

■ i ! 

| 2 | Bead error | 

L J. J 

| Ah error has been detected in a read operation. j 

r t t i 

| 3 | | Reserved for IBM use only. | 

| 4-7 | | The four user-reserved bits which can be set on (value 1) and| 

| | j tested in any user-written routine. | 


Figure 30• Communication Line Error Eyte (audio lines) 


The CHECKARU macro instruction may be 
issued anywhere in the Audio IPS and used 
as frequently as desired. 

r- T ----i 

|Cperaticn|Operand | 


|CHECXARU jfliask, j 

| |/=X , iressage , | | 

| llmsgchar ) j 

t___ x ___ J 

mask 

Is the hexadecimal representation of 
the tit configuration of the error 
byte attached tc an audio line. 

message 

Is the address chain representing the 
user*s audio error message. The 
framing X and quotes must te coded. 
When this cperand is used, the length 
cf the address chain, including the 
length representation, must not exceed 
61 bytes. The first two bytes of the 
address chain must contain the lengtl' 
cf the chain. 

msgchar 

Is the address of the area defined by 
the user which contains the address 
chain representing the user*s audio 
error message. The first two bytes of 
the address chain must ccntain the 
length of the chain. 


Legging (LOGSEG) Macro Instruction 


the sequence in which they are received 
preceded by the symbolic assignment of the 
receiving audio line (3 bytes )„ the length 
of the input message (3 bytes),, and the 
date stamp information (8 bytes). If the 
input message is coming in via an audio 
line of a line group defined by a DTFQT 
macro instruction with the LOGTIME=YES 
operand, automatic time stamping will be 
performed in an area reserved via this 
LOGTIME operand. In this case,, the logged 
input message includes the symbolic 
assignment of the audio line (3 bytes), the 
length of the input message (3 bytes), the 
date stamped information (8 bytes), the 
time stamped information (8 bytes), and the 
input message itself. In either case, 
these successive fields are separated by a 
one-byte separator (minus sign). Note that 
the unused part of the input buffer is 
reset to X*00*. 


The LOGSEG macro instruction with the 
ARU operand may appear in any place and 
more than once in the Audio LPS W if the 
ARUMGTYP macro instruction is used to 
define different types of input messages. 

The logging effected by LOGSEG is in 
addition to the logging associated with the 
queueing procedure of QTAM. Use of LOGSEG 
is optional. 


r~- T -- 

| Operation|Operand 

-+----— 

j LOGSEG j filename [„PREFIX] 

I I Laru J 

l---J-- 



For audio messages, the LOGSEG macro 
instruction with the ART) operand enables 
the user to log input messages (to place 
them on an output device as a record cf the 
input message traffic carried by the audio 
lines). The input messages are logged in 


filename 

Is the name of the ETF table that the 
user must define to specify the 
parameters of the file used for 
logging the audio input messages. 
TheDTFxx macro instruction for the 
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file on which the messages are logged 
irust specify V*CRKAFEA=YE£. 

(1) may he used to specify that the 
address of the ETF table is in 
parameter register 1. The address 
must be loaded into register 1 prior 
to execution of this macro 
instruction. 

PREFIX 

Specifies that the QTAM header or text 
prefix is to be included with the 
logged segment. If this operand is 
net coded, the prefix is net legged. 
The first 8 bytes of the prefix are 
not included. Thus a header segment 
is legged with a 24-byte prefix and a 
text segment is logged with a 14-byte 
prefix. The format of the QTAM 
prefixes is contained in Appendix A. 

ARE 

Specifies that the message to be 
logged is an audio input message. 

This operand is reguired fer each 
ICGSEG macro instruction issued in an 
Audic IPS. 


Audio Answer Repetition (REPEAT) Macrc 
Instruction 


The REPEAT macrc instruction can only be 
used in the Audic IPS of line groups 
operating in conversation mode. It enables 
the user to obtain a repetition of the 
previous audio answer, if any. 

(Conversation mode may be specified in the 
CMCDE operand of the DTFQT macrc 
instruction fer the line group.) 

The first character of the input message 
is compared with the character specified in 
the operand cf the REPEAT macro 
instruction. If these two characters are 
different, the REPEAT macro instruction 
produces no effect on the input message. 

If these two characters are the same, or if 
there is no operand in the REPEAT macro 
instruction, the input message is tested to 
determine whether it is the first input 
message in the conversation (the repetition 
request cannot be considered as the first 
input message). If the input message is 
the first input message in the 
conversation, the repeat bit in the line 
errer byte is set on by the REPEAT macro 
instruction. In this case, if the user 
tests the repeat bit by using a CHECKARU 
macro instruction, an error message is sent 
to the calling terminal. If the repeat bit 
is net tested, the REPEAT macro instruction 
has nc effect on the input message. If the 
input message is net the first input 
message in the conversation, the REPEAT 


macro instruction results in repetition of 
the last audio answer. 

The REPEAT macro instruction may be 
issued more than once,, anywhere in the 
Audio LPS, depending on the use of the 
AFUMGTYP macro instruction. 

r ---T- 1 

] Operation | Operand | 

f-+-^ 

| REPEAT j (codechar] | 

l_ Jl -J 

codechar 

Is the repeat code, and may be any 
character. It must be specified as 
either the character itself or the 
hexadecimal representation of this 
character. The framing C or X and 
quotes must be coded. 


Translate (TRANS) Macro Instruction 


For audio messages,, the TRANS macro 
instruction results in the translation of 
the input messages, character by character, 
jfrom ARU code into EBCDIC representation 
(the input messages are in ARU code when 
they are transferred to main storage). The 
TRANS macro instruction must not be used 
for the messages coming in from IBM 3944 
Dial Terminals via a 7772 ARU with Dial 
Terminal Features, because these messages 
are already in EBCDIC representation. 

Code translation is accomplished either 
through a RCVARU table provided by QTAM, or 
through a user provided table. The user 
may omit the TRANS macro instruction and 
work with ARU code; in this case, the 
operands of the ARUMGTYP, CHECKARU,, or 
REPEAT macro instructions must be specified 
in ARU code representation. 

The TRANS macro instruction, when used, 
must precede any ARUMGTYP, CHECKARU, or 
REPEAT macro instruction. 


r - T -.-T 

| Operation | Operand | 

I-- + -1 

j TRANS j table j 


table 

Is the name of the code translacion 
table. It may be RCVARU or the name 
of a user-provided table 

Example : A TRANS macro instruction to 

translate input messages sent from an audio 
terminal other than an IBM 3944 Dial 
Terminal to the computer: 
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-T-—1 

| Operation | Operand | 

I-- + -^ 

I TRANS j RCVABU | 

l _JL_ J 


INCLUEING A USER-WRITTEN ROUTINE WITHIN THE 
AUDIO LPS 


The design of an IPS section is such 
that a serially-reusable, user-written 
routine can be included. Linkage tc a 
closed user-written routine can be included 
in any subgroup within the Audio LPS. 

There are several reasons why the user 
iright want tc include such a routine. 

For audio messages : The user may wish tc 
process particular information included in 
the input messages and change the contents 
of these messages. Cr, he may desire to 
execute his own errcr-checking routines on 
the input messages (for example, checking 
the length and nature of the contents). If 
the length or the nature of the information 
is not in accordance with the length or the 
nature of the expected input messages, the 
user can set on (value 1) a user-reserved 
tit in the line-error byte. Ey testing 
this bit with a subsequent CHECEARU macro 
instruction, the user may issue an error 
message tc the calling terminal. The user 
may have access tc the following 
information contained in each audio line 
control block (A.LCE) labeled: 

• IJLQLIML input message length 
(half-word) 

• IJLGLIBA input message address 
(full-wcrd) 


• IJLQLERB line-error byte 


Before passing control to the LPS, QTAM 
places the address of the ALCB associated 
with the line involved in register 4. The 
expansion of the LPSTART macro instruction 
establishes this register as the base for 
the ALCB DSECT generated by the expansion 
of the TERMTBL macro instruction. 


For all messages : To include a 
user-written, closed routine, the user must 
provide his own linkages. QTAM requires 
that the user-written routine save and 
restore the registers by standard register 
saving conventions. Register 13 contains 
the address of a QTAM-provided save area to 
be used for this purpose. If the 
user-written routine calls a second 
user-written routine, it must provide its 
own save area v etc. Figure 31 shows the 
control flow between an LPS and a closed, 
user-written routine. 


Before entering the LPS section,, the LPS 
control routine initializes certain 
registers with data that is used by many of 
the LPS macro instructions in performing 
their functions. For this reason, the 
registers must be preserved. The register 
contents are described in Appendix D and 
may be useful to the user in coding his own 
LPS routine. For example, if the 
user-written routine processes a field in 
the nonaudio message header, the scan 
pointer register (register 5) may be used 
for scanning the field; if used, it must be 
updated to point to the end of the field 
(as described in Appendix D) upon return to 
the LPS. 
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The user also has the capability to 
include his own instructions as in-line 
code in the IPS, If any of the following 
registers are required for other than their 
intended purpose (see Appendix D)„ they 
must be saved and restored before execution 
of the next (in-line) IPS macro 
instruction: register 4* 5„ 6, 7„, 8„ 9 W 
and 13. If any of the following registers 
(work registers for the IPS macro 
instructions) are used, they must be saved 
before execution of the next LPS macro 
instructions and restored when needed: 
register 2, 3„ 10, 11, ; and 12. 


Note: Issuance of a Supervisor WAIT macro 

instruction from a user-written LPS routine 
(or in-line in the IPS) halts all 
processing of LPS macro instructions in the 
message control program until the condition 
being vfaited for is satisfied. WAIT,, 
therefore,, should either not be used,, or be 
used with extreme care. The ATTACH and 
DETACH macro instructions may not be used 
in a user-written LPS routine. 


figure 31. Activation of a Closed User 
Written Routine in the Audio 
LPS 
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NETWORK CONTROL FACILITIES (AUDIO LINES) 


Examination and modification of the 
status of the telecommunications system is 
principally dene in the message processing 
program. For a complete discussion,, refer 
to the publication, CTAM Message Processing 
Program Services . 

Macro instructions are provided by QTAM 
which enable the user to dynamically: 

• Activate or deactivate a particular 
line in an audic communications line 
group (STARTAFU and STOPARU macro 
instructions). 

• Add the feur threshold counters for a 
line to the feur cumulative counters 
fer that line, examine the cumulative 
system, and reset the threshold 
counters (CCFYC macro instruction). 


LINE ACTIVATION AND EEACTIVATIOK 


The lines in a line group are 
automatically activated for message 
transmission when the line greup is opened 
in the message control program. When 
issued in a message processing program* the 
STOPARU and STAFTIN (or STARTAFU) macro 
instructions enable the user to dynamically 
deactivate and reactivate a specific line 
(or all the lines) within the line group at 
any pcint during the operation cf the 
system. 

STOPARU is used to effect a temporary 
deactivation cf a specific line when the 
line is expected to be reactivated by a 
subsequent STAFTIN (cr STARTAFU) macro 
instruction. STOPARU can also be used in 
the message contrcl program to defer the 
activation of a specific line. For 
example, if traffic is not expected on a 
line at the time the line group is 
initially opened in the message control 
program, that line can be deactivated by a 
STOPARU macro instruction. The line can be 
activated later by a STAFTIN macro 
instruction in a message processing 
program. 

If STARTIN is used in the message 
contrcl program, it must be issued after 
the line group is opened and before the 
ENDFEADY macro instruction. 

If STARTAFU is used during the 
initialization cf the message control 
program, it must he issued after a 


corresponding STOPARU. If STOPARU is used, 
it must be issued after the opening of the 
corresponding audio line group and before 
the ENDFEADY macro instruction. STOPARU 
and STARTARU may be used anywhere in the 
Audio LPS section of the message control 
program. 


Stop Audio Line (STOPARU), Macro Instruction 

The STOPARU macro instruction removes an 
audio communication line from active use, 
but the line is disabled only after 
completion of any initialized transaction 
on line. A stop flag is set on for the 
designated audio line and control then 
returns to the program which issued 
STOPARU. This stop flag is tested whenever 
the audio line must be enabled to allow the 
reception of the next transaction. If it 
is on, the line remains disabled; if it is 
off, the line becomes enabled. 

If the STOPARU macro instruction is 
issued when the audio line is already 
enabled, the line will be deactivated only 
after the processing of the next 
transaction awaited on this line. 

|Name ]Operation j Operand | 


j(symbol)jSTOPARU j filename, /rln\ j 

I i I lALL/ | 

L_J._JL---„-J 

symbol 

Is the name of the macro instruction, 
filename 

Is the name of the DTF table for the 
line group containing the line to be 
deactivated. It must be identical to 
the name of the DTFQT macro 
instruction that generates the DTF 
table for the line group„ 

If register notation is used, the 
address of a location containing the 
name must be in the general register 
designated. The field that contains 
the name must be eight bytes (CL8) in 
length (padding with blanks is 
required for names shorter than eight 
bytes). 

rln 

Is the relative line number, within 
the line group, of the line to be 
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deactivated. If register notation is 
used, the general register specified 
must contain the relative number in 
binary fcrir. 

AIL 

Specifies that all lines in the line 
group are to be deactivated. 

If a specification error is detected, an 
error code is returned in register 15. The 
error ccnditicns tested for, and the return 
code for each, are contained in Appendix G. 


Start Audio Line (STARTARU) Macro 

Instruction 
. .. ' — 

The STARTARU macro instruction can be 
used to allow message transmission to 
resume on one line, cr on all lines in the 
same audio communication line group. 
Normally, these lines have been previously 
disabled by the STCFARU macro instruction, 
and the user must have previously opened 
the audio line group in the message control 
program. 

The stop flag cf each specified audio 
line is tested. If it is off, the 
corresponding audic line is already in 
active use, and the STARTABU macro 
instruction produces no effect. If it is 
on, it is set off, and the corresponding 
audio line is enabled with the initial 
condition specified in the CMODE operand of 
the DTFQT macro instruction issued for the 
concerned audio line group. Control is 
then returned to the program which issued 
the STARTARU macro instruction. 

Initial enabling cf lines in an audio 
line group starts when the line group is 
opened in the message control program. 

If a disable switch on an IBM 7772, a 
"make busy” switch cn an IBM 7770, cr the 
meter switch on either device has been 
turned tc disable, a STARTARU macro 
instruction must be issued to enable the 
ARU lines for use after these switches have 
been turned back tc enable. 

r - T -T- 1 

|Name |OperationJ Operand | 


j{symbol]jSTARTARU j filename, /rln\ j 

I I I (ALL) | 

l--L-X-,-J 

symbol 

Is the name cf the macro instruction, 
filename 

Is the name cf the BTF table for the 
line group containing the line to be 


reactivated. It must be identical to 
the name of the DTFQT macro 
instruction that generated the DTF 
table for the line group. 


If register notation is used,, the 
address of a location containing the 
name must be in the general register 
designated. The field that contains 
the name must be eight bytes (CL8) in 
length (padding with blanks is 
required for names shorter than eight 
bytes). 


rln 

Is the relative line number, within 
the line group, of the line to be 
reactivated. If register notation is 
used, the general register specified 
must contain the relative line number 
in binary form. 

AIL 

Specifies that all lines^ in the line 
group are to be reactivated. 

Error returns from this macro instruction 
are contained in Appendix G. 


EXAMINING AND MODIFYING LINE ERROR COUNTERS 


Eight counters are provided for each 
line in the system: four threshold 
counters, and four cumulative counters. 
Each cumulative counter corresponds to one 
of the threshold counters. 

For audio lines, the threshold counters 
keep a count of the number cf: 

1. Transmissions. 

2. Hang^up operations. 

3. Data checks for read operations. 

4. Data checks for write operations. 

For further information, refer to the 
Error Recovery Procedures section. 


Copy Error Counters (COPYiC) Macro 
Instruction 

This macro instruction does not apply to 
the IBM 2260x2848 Local. COPYC causes the 
I four cummulative counters of the line 
I specified to be placed into a designated 
work area. The threshold counters are 
reset to 0. 
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1 


rln 


f- r -r-T 

(Name (Operation | Operands | 

I*-+-+-*-^ 

| [symbol] |CCP¥C | linename, [rln], j 

j | j workarea | 

l -jl_ x _ 


symbol 

The name of the macro instruction* 
linename 

The name cf the audio line whose error 
counters are to he copied. If 
register notation is used* the general 
register designated roust contain the 
address cf a location containing the 
naire of the line. The field that 
contains the naire roust be n bytes 
long, where n equals or exceeds the 
length of the longest name of any 
audio line table entry. If an invalid 
audio line naire is specified, no data 
rocveroent take place. An error 
indicator cf X*20* is returned in 
register 15. If no error is detected, 
register 15 contains 0. 


The relative lin* number,, in the line 
group of the line over which the 
terminal communicates with the 
computer. If this operand is not 
used, its absence must be indicated 
with a comma. 


workarea 

The address of the area into which the 
information is placed. The size of 
the work area must be ten bytes. If 
register notation is used, the general 
register designated must contain the 
address of the work area. 


Bytes one through four of the work 
area contain the number of 
transmissions; bytes five and six, the 
number of hang-up operations; bytes 
seven and eight, the number of data 
checks for read operations; and bytes 
nine and ten* the number of data 
checks for write operations. 
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QTAM SERVICE FACILITIES (AUDIO BUSIES) 


This section discusses the applicability 
tc audio lines cf the following services 
that QTAM provides tc aid the user in 
network control, errcr recovery and 
testing: 

• Operator Control Facility 

• Errcr Recovery Procedures 

• Operator Awareness 

The Cn-line Teririnal Test Facility is 
net applicable tc audio lines and cannot be 
used. The effect of the Checkpcint/Restart 
Facility is discussed below. 


1052 system console. By specifying the 
OPCTL=chars operand under the TERMTBL macro 
instruction and defining the OPCTL macro 
instruction causes instruction and defining 
the OPCTL macro instruction causes these 
error messages to be sent to the operator 
control terminal. If this is done, error 
messages originating from errors on the 
operator control terminal are sent to the 
IBM 1052 system console. 


OPERATOR CONTROL FACILITY 
— —— ^ - - —» — — ——• 


INPUT CONTROL MESSAGE DESCRIPTIONS 


The Operator Control facility allows the 
execution of QTAM macro instructions by 
special ccntrcl messages received from 
specified operator control terminals. The 
QTAM macros supported under this facility 
for audio lines are: CCPYC, STARTARU, and 
STCFAEU. 

The user has three choices fer operator 
control support: 

1. Ncne, 

2. Operator control facilities only, or 

3. Operator ccntrcl facilities with error 
messages sent tc the operatcr control 
terminal(s). 

The following table summarizes how each 
option may be specified. 


Copy Error Counters (,CQPYC) 


| This message causes the four cummulative 
counters of the line specified to be 
printed at the source terminal. The 
threshold counters are reset to 0,. The 
data is in decimal format. If the control 
message and the counters copied exceed 
buffer size, only that portion of the 
output message that the buffer can contain 
is printed. 


r -—-T-T-1 

| Identifier |Function|Operands | 


jctlmsg jcoPYC J /termname rln\ j 

I ] ] /linename j j 


r ---r- T -*- 

Facility | TERMTBL Macro 


CPCTL Macro 


Ncne 


j Not specified 


Net defined 


Operator j Not specified 
ccntrcl | 
only I 


Defined 


Operator | CPCTL=chars 
control j 
with | 

errcr | 
message j 

- x - 


Defined 


Errcr messages frem the Error Recovery 
Procedures (tut not error messages 
originating from the ERRMSG macro 
instruction) are normally sent to the IEM 


ctlmsg 

The control message identifier. It 
must be the same as that specified in 
the OPCTL macro instruction. 

termname 

The name of any terminal for which 
counters are desired 

linename 

The name of the line for which 
counters are desired. 


rln 

The relative line number of the line 
in the line group. It must be in 
hexadecimal. If specified, indicates 
that all lines in the line group are 
to be stopped. 
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Start audio Line (S1ARTARU) 


This message causes transmission tc 
begin or resume on a line or cn all lines 
in an audio line group, provided the line 
group is opened. 


Identifier 

(Function|Operands 

4 4 

ctlrnsg 

j' STABTARU j linenaire [AIL] 

_ X _J.___ 


ctlrnsg 

The control message identifier. It 
must be the same as that specified in 
the CPCTI macro instruction, 

linename 

The name of the audio line that is to 
be started. 

ALL 

If specified, indicates that all lines 
in the line group are to be started. 


Stop Audio Line _( STCFARU ) 


This message removes an audic 
communications line from active use. If 
transmission is cn the line, the line is 
not stopped until the transmission has 
completed. 

r - 7 - T --j 

(Identifier |Function|Operands | 

F-+-4-^ 

jctlrnsg ISTCFARU (linename {ALL] j 

i-- ± _ ± - r -J 


ctlrnsg 

The control message identifier. It 
must be the same as that specified in 
the CPCTI macro instruction. 

linename 

The name of the audio line to be 
stepped. 

ALL 

If specified, indicates that all lines 
in the line group are to be stepped. 


CHECKPOINTING AND RESTARTING THE MESSAGE 
CONTRCL PROGRAM 


This facility does not apply to a system 
consisting of audic lines only. If a 
system including audic lines is restarted. 


the audio lines will have the same status 
as in the initial program load. 


ERROR RECOVERY PROCEDURES 


The error recovery procedures are a 
comprehensive set of procedures for dealing 
with all kinds of input/output errors that 
may occur within the telecommunications 
system. 

Upon occurrence of an input/output 
error, the error recovery procedures 
examine the sense bits and CSW status bits 
to determine which type of error has 
occurred. Depending upon the type of 
error,, the following functions may be 
performed: 

1. The failing action is retried two 
times* and on the third occurrence of 
the error,, an operator message is 
provided, 

2. The failing action is not retried, and 
an operator message is immediately 
provided, 

3. The type of failing action is counted 
in a threshold counter, or 

4. A combination of 1, 2 V and 3* depending 
upon the type of terminal on which the 
error was detected. 

Note : if the error is counted in a 

threshold counter, it is counted every 
time that it occurs, including both of 
the two retry attempts. Messages to 
the operator are normally sent to the 
IBM 1052 system console. However,, if 
the OPCTL=chars operand is specified in 
the TERMTBL macro instruction, they are 
sent to the operator control terminal. 
For further information, refer to the 
Operator Control .Facility and TERMTBL 
Macro Instruction sections. 

Eight counters are provided for each 
line in the system: four threshold 
counters and four cumulative counters,. 

Each cumulative counter corresponds to one 
of the threshold counters. 

For audio lines, the threshold counters 
keep a count of the number of: 

1. Transmissions. 

2. Hang up operations. 

3. Data checks on read operations 

4. Data checks on write operations. 


148 DCS QTAM Message Control Program 









Whenever any one ci the three error 
threshold counters (fcvt not the 
transmissions threshold counter) reaches a 
specified threshold v<lue, the following 
action is performed: 

| 1. A message is provided to the operator 
shewing: 

a. The threshold value specified for 
each threshold counter, and 

b. The value in *ach threshold counter 
at this time, 

| 2. The threshold coulters are reset to 0. 

Whenever the transmissions threshold 
• counter reaches its threshold value,, the 
I threshold counters are reset to 0„ hut no 
message is provided. 

The threshold values represent the 
number of the three types of errors 
considered excessive within a certain 
number of total transmissions. These 
values are specified in the THRESH operand 
under the ETF macro instruction for the 
line group in which the line is located. 

The threshold value for any of the four 
threshold counters must not be more than 
255. However, the threshold values 
specified for any of the three error 
counters should be enough less than that 
specified for the nun her of transmissions 
to allow an error message tc be provided. 

If the THRESH operand is omitted, the 
following values are assumed: 


Nc. cf Transmissions: 255. 

Nc. cf Hang-up operations: 255. 

Nc. of Data checks on: 

Bead operations: 5. 

Write operations: 5. 

Error recovery procedures also provide 
the CCFYC macro instruction. For further 
information* refer tc CCFYC K acro 
Instruction. 


GFERATCB AWARENESS 


Operator awareness messages are provided 
for all permanent and unrecoverable errors 
and excessive temporary errors as 
determined by the line error threshold 
counters. These messages are printed on 
the 1C52 system console unless operator 
control CCFCTI macro instruction) is 
specified. When operator ccntrcl is 
specified, all operator awareness messages 
pertaining tc the operation of the data 
links are sent to the telecommunications 
system ccntrcl terminal. 


4QnnI text SYSnnn=cuu LCB=xxxxxx 
TI=xxxx DC=xxxxxxxxxx 
CSW17=xxxxxxxxxxxxxxxxxx 
CCW=xxxxxxxxxxxxxxxx SN-XXXX 


where: 


4QnnI 

Is the standard message code for the 
operator. The internal component name 
is 4Q, the serial is nn„ and the 
action code is I for informational 
(immediate operator action is not 
required). 


text 

Type of error detected. 

SYSnnn=cuu 

Is the symbolic unit assignment of the 
device, and cuu is the actual unit 
assignment of the device. 

LCB=xxxxxx 

Is the address of the line control 
block for the terminal or of the Audio 
line control block for the Audio line. 

TI=xxxx 

Is the terminal ID (polling or 
addressing characters) in hexadecimal 
format. If only one polling character 
is used* it will be left justified in 
this field. This field is not 
included in Audio messages. 

DC=xxxxxxxxxx 

Is the hexadecimal representation of 
the dial characters for the terminal. 
This field is not included in Audio 
messages. 

CSW17=xxxxxxxxxxxxxx 

Is bytes 1 through 7 of the channel 
status word as specified in the 
channel command block (CCB) in 
hexadecimal format. 

CCW=XXXXXXXXXXXXXXXX 

Is the failing channel command word 
(CCW) in the channel program in 
hexadecimal format. 

SN=xxxx 

Is the sense byte as specified in the 
channel command block (CCB) in 
hexadecimal format. 

The format of the error count threshold 
message for audio lines is: 

4Q00I LINE ERROR THRESHOLD REACHED 
SYSnnn=cuu TR=aaa/bbb HU=jjj/kkk 
RDC=lll/mmm WDC=nnn/ppp 
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where: 

TR=aaa/fcbfc 

aaa is the threshold value for the 
number of transmissions specified in 
the DTF/keywcrd THRESH* and bbfc is the 
number of transmissions attempted up 
to the time an error threshold was 
reached. This information is in 
decimal format. 

HH=jjj/kkk 

jjj is the threshold value for the 
number of hang-up operations specified 
in the THRESH parameter* and kkk is 
the number that occurred* in decimal 
format* in the past bbb transmissions. 


RDC=lll/mmm 

111 is the threshold value for the 
number of errors on read operations 
specified m the THRESH parameter* and 
mmm is the number that occurred*, in 
decimal format* in the past bbb 
transmissions. 


WDC=nnn/ppp 

nnn is the threshold value for the 
number of errors on write operations 
specified in the THRESH parameter* and 
ppp is the number that occurred* in 
decimal format* in the past bbb 
transmissions. 
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Nofe: All DSECT names have the prefix IJLQ. 


Field Faroe 


IJIQTSZE 


IJLQICAE 


Eunction 


All entry types : £peci- 
fies f entry size (in 
bytes) and provides ac¬ 
cess to the next higher 
teririnal table entry. 

All entry types: Contains 
the address of the £CB 
fcr the queue on vhich 
outgoing iressages tc the 
destinations ire 
placed. 

Using this address iden¬ 
tification, the queue¬ 
ing routine places each 
iressage cn its appro¬ 
priate queue. 

Fete : Fcr audio iressages, 
this field contains a 
pcinter tc the FS process 
queue. 


Start 

Location 


byte 0 


jField 
jLength 

* - 

i 

|1 byte 


byte 1 J 3 bytes 


jvalue 
]provided 
Form J by 
- 1 - 


binary Jir.acro- 
nurober jgenerator 


binary ]macro- 
address Jgenerator 


Value 

Range 


1-255 


Initialj 
Value | 

-4 


Figure 32. Terroinal-Table Entry Formats (Part 1 of 5) 
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IJLQTSIN 


IJLQTSCT 


IOLQTLRA 


IJLQTSTA 


I Single-terminal entries ; 
(Stores and maintains a 
(sequence number for in- 
| coming messages from 
(the terminal represented 
(by this entry. The SEQIN 
jmacro instruction uses 
(this value as a check 
(against the sequence nuir- 
jber appearing in the in- 
jcoming message header. 


Single-terminal, qrcup- 
code, process-program 
en trie si Provides arid 
maintains a sequence num¬ 
ber fcr cutgoing mess¬ 
ages tc the destina¬ 
tion (s) represented by 
this entry. The SECOUT 
macro instruction ob¬ 
tains the current value 
from IJIQTSCT and places 
it in the outgoing mess¬ 
age header. The sequence 
number is incremented by 
1 each time the number 
is placed in a message. 

If a terminal is repre¬ 
sented by both a single- 
terminal entry and a 
grcup-ccde entry* only 
the IJI£TSCT field in the 
grcup-ccde entry is in¬ 
cremented when a message 
is transmitted via 
group-code addressing,. 

Distribution-list entry : 
Contains the address of 
the beginning of the 
terminal list pcrticn of 
this entry* relative to 
the address of byte 0 of 
the entry. The terminal 
list portion consists of 
subfields reladdr i<7 ... 
reladdr r . 

All entry types : Indi¬ 
cates various communi¬ 
cation conditions as¬ 
sociated with the ter¬ 
minal (s) represented by 
this entry. 


byte 4 


byte 6 


byte 6 


byte 8 


32 bytes(binary JQTAM 
J |count j 

J I J 
1 ! I 
1 3 3 


J2 bytes(binary |QTAM 
J ]count j 


byte (binary jjmacro- 

Jrela- (generator 
|tive | 
l addressj 


1 1 

byte |binary Jmacro- 

Jstatus 3 generator 


0-9999 J1 


0-9999 


speci¬ 

fic 

bits 
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-T 

l Eit 0 : attention bit; | 

| initially set tc 0. Thisj 
| bit is set tc 1 when an | 

|Attention interrupt (readj 
(request) is received frcrr j 
(the 2260 Local repre- | 
(sented by this entry. It| 
jis reset to 0 when the j 
(read request is serviced.! 
(This hit applies only to j 
(a 226C Local. | 

I I 

( Bit 1 : Channel queue | 
(bit; when the CCE for j 
(this 2260 Local is cn the| 
(DCS channel scheduler j 
jqueue, this bit is set tcj 
|1. Otherwise, it is set j 
jtc 0. This bit applies | 
(only to a 2260 Local. | 

I I 

( Bit 2 ; Input allowed | 
(bit; initially sent to 0.| 
(This tit is set tc 1 by | 
| the Open routine if the j 
(2260 Local represented by| 
(this entry appears in the) 
(polling list for the line) 
(group. This bit applies j 
jcnly tc a 2260 Local. j 

I I 

l Eit 3; Printer bit; this| 
(bit is initially set to ij 
(if the terminal repre- j 
jsented by this entry is aj 
j1053 Printer in a 2260- | 

j 2848 Local line group w orj 
| if it has been specified j 
|as an IEft 2740 Model 2 | 

(terminal. Otherwise, it j 
(is set tc 0. j 

I I 

( Eit 4 ; FELEASEft pending j 
j bit! initially set tc j 
(zero. Set to 1 when j 

(FELEASEft has been j 

(requested but has net yet| 
(completed. Feset tc zerc| 
(when FEIEASEft completes | 
|(i.e., when the next mes-j 
(sage for a terminal is | 
(read frem DASD)• | 

1 I 

( Eit 5 : Intercept bit; | 
(initially set to 0. | 

| This hit is set tc 1 j 

(upon issuance of an j 

| INTEFCPT macro instruct j 
jtion tc indicate that a | 
(message cn the queue was | 
(net transmitted. It may j 
(be reset to 0 by a CHNGT | 
(or FELEASEft macro in- | 
jstructicn when transiris- j 
jsicn can be resumed. | 


Figure 32. Terminal-Table Entry Formats 
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Bit 6 : Send fcit; ini¬ 
tially set to 1. This 
fcit is set to 0 upon 
issuance of an INTEECPT 
macro instruction, indi¬ 
cating that messages on 
the gueue for the des¬ 
tination are withheld 
from transmission* It 
may fce reset to 1 fcy a 
CBNGT cr RELEASEM macro 
instruction when trans-* 
mission can be resumed. 

Bit 7 s Receive fcit; ini¬ 
tially set to 1. This 
bit is set to 1 tc indi¬ 
cate that the ter¬ 
minal represented fcy 
this entry is being 
polled. It may fce set 
tc 0 tc prevent polling 
of the terminals. Set¬ 
ting tc 0 or 1 is 
achieved fcy means of the 
CHNGT macro instruction. 
Note: Bit 7 is not ap- 

licafcle tc, and is not 
used fcy, group-code, 
distribution-list and 
process-program entries. 


IJIQTTID 


^ All en try types : Ccn- 
jtains the name of the 
|terminal(s) that this 
jentry represents, in the 
| form cf a terminal code 
j(or code for the prc- 
j cess-prcgram). This 
{code is the same code 
{that can appear in the 
jsource cr destination 
jcede field cf the mes- 
jsage header. 

i Ncte : Fcr audio messages, 
(this code must appear in 
(the BTF table defined fer 
Jthe audio line groups 
{using a process-program 
(entry. 


byte 9 


jl to 8 'J EBCDIC 
] bytes 'jj char- 
jj || acters 

J }(upper- 

j lease) 

1 1 

] ] 


IJIQTSDR 

(optional) 


1 -Sinqle-terminal entries: 
(contains the offset of 
jthe SER counter set 
| assigned to this 
(terminal. This field 
(is included only if the 
(OER/SER cption is in use. 


Imire- ] 2 bytesJ binary 
dlately } (count 

following! ] 

IJLQTTIE J } 

i i 

i i 


4 - 

JQTAM 


Figure 32. Terminal-Table Entry Forirats (Part 4 of 5) 
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User 

area 


Device 

access 

area 


reladdr 


IJLQTfcCH 



T““'“-— —— "I"———— Tf——— 

t- 

T-- 

T -“1 

Sinqle-terroinal and 

|(see j 

Cumula- 

|As spec-)User 


3-- 

qroup-code entries: Con- 

j Ncte 1) 

| tive 

ifled by] 

1 

3 

tains such data as the 

1 

lenqth 

(OPTION 

i 

! 

1 

particular application 

1 

of all 

]macros 

i 

1 

1 

may require, e.g., alter- 

1 

sub- 

i 

i 

I 

i 

1 

nate destination codes. 

1 

fields 

i 

i 

1 

1 

polling limit parame- 

1 

in entry] 

] 

1 

3 

ters, and diagnostic in- 

1 


i 

i 

1 

1 

formation. The user area 

I I 


i 

i 

1 

9 

consists of a contiguous 

i : 


i 

i 

1 


series of subfields 

i 


i 

i 

i 

1 

whose form, length, and 

1 ! 


i 

i 

I 

1 

contents are specified 

i 


i 

i 

1 

1 

by means of OPTION and 

! 


i 

i 

1 

1 

TERN macro instructions 

1 


1 

i 

! 

1 

(see the descriptions of 

1 


1 

j 

! 

1 

these macros. 

I 

| 


i 

i 

i 

1 

I 

3 

I 

Sinqle-terminal and 

1 

|Iirmedi- 

Cumula- 

1 

|Device 

] 

j User 


1 

J — 

group-rccde entries: For 

lately 

tive 

j code 

l 

1 

1 

ncnswitched terminals* 

| follow- 

length 

i 

i 

1 

1 

contains the polling and 

j ing user 

of all 

i 

i 

1 

\ 

addressing characters 

* area 

sub- 

i 

9 


! 

for the terminal(s) re- 

i 

fields 

i 

! 

! 

! 

presented by this entry. 

i 

in entry| 

3 

1 

1 

These characters are 

! f 
1 


i 

1 

1 

1 

specified by the "ad- 

1 


i 

9 

1 

1 

dressing” operand of the 

i : 


i 

J 

1 

1 

TERR macro instruction. 

i 


i 

1 


! 

Fcr a 2260 or 1053 in a 

i 


i 

j 

i 

! 

2260-2848 Local line 

i 


i 

1 

i 

i 

group, this field 

i : 


i 

i 

i 

i 

contains the CCE and 



i 

i 

i 

i 

ether information re¬ 

i i 


i 

3 

i 

i 

quired fcr the terminal. 

i ] 


i 

3 

! 

i 

For foTTA terminals this 

i ; 


i 

3 

1 

i 

field contains the termi¬ 

! ] 


i 

11 

1 

i 

nal identification 

1 1 


i 

fj 

1 

I 

9 

sequence. 

1 9 

! l 

i 

1 

J 

I 

1 

1 

J 

Distribution-list ertr- 

1 i 

|Immedi- ]2 bytes 

I 

|Binary 

\ User 

1 

i 

ies: Contains the ad¬ 

jately jper 

|rela- 

3 

1 

r 

dress of a single-terminal 

j follow- ] subfield 

j tive 

3 

1 

i 

entry relative to the 

|ing j 

j address 

r 

1 

i 

address of the terminal 

jTJLQTTIDj 

i 

9 

! 

i 

table (i.e., IJLQTTEL). 

j subfield] 

i 

9 

1 

9 

The last "reladdr" sub¬ 

i i 

i 

J 

1 

i 

field is set to 0, indi¬ 

i i 

i 

9 

1 

i 

cating the end of the 

i i 

i 

1 

1 

i 

terminal list portion of 

1 9 

i 

1 

I 

i 

the distribution-list 

1 1 


t 

i 

1 

i 

entry. 

1 9 


i 

3 

1 

i 

Audio prccess-proqram 

|Fellow- ]4 bytes 

|Binary 

3 QTAM 

|- 

i— 

entries: Contains the 

1 ing ! 


(address 

i 


! 

address of the first input 

|IJLQTTIDj 

i 

1 

1 

1 

message to be transferred 

j subfield] 

i 

i 

1 

1 

to the RS-process queue. 

j after j 

i 

3 

1 

1 

This field is adjusted on 

(adjust- j 

i 

1 

1 

1 

a full-word boundary. 

| m<jnt J 

i 

9 

1 

1 

_j_j 


Note: Start location immediately fellows the IJLQTTID or IJLQTSDR subfield. Symbolic 


references may be made to the optional subfields named by OPTION macro instructionn. 


Figure 32. Terminal-rTable Entry Formats (Fart 5 of 5) 
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m 

H* 

m 

c 

m 


uj 

U) 



W 
K 
Q» 
3 
•n 


o 

hh 


►3 

fD 

3 

H* 

a 


h3 

o> 

tr 

H-* 

fD 


Optional 
SDR area 



Field Field 


Messages 
for these 
terminals 
are queued 
by terminal 


Messages 
for these 
terminals 
are queued 
by line 


9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25 ,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44, 


NOTES: 

1 . ALTDEST and POLUMIT are optional fields specified by OPTION macro and "opdata" operands of TERM macro instructions. 

2. Fields and bytes in which no characters appear contain binary zeros or blanks. 

3. Fields and bytes used by the audio lines are shown on the squares drawn in thick lines. 







Polling List for Nonswitched Lines and for IBM 2260-2848 Local: 


112 2 2 

_ 11 _ 

Size 

B 

Pointer^ 

B 

Pointer 

n 

Stop 

Polling List for Nonswit 

1 1 


-v- 

Omitted for Output - Only Lines 

;hed Lines (Autopolled Lines). 

1 1 or 2 1 1 or 2 1 1 

_ 11 _ 

Size 

Status 

Identifier 

PA i 

h 

B 



Stop 

> J 

Polling List for Nonswitched Lines (WTTA Terminals): 

1111 n 

Size 

Status 

00 

m 

CPU Identification Sequence 

3 olling List for Switched IBM 1050: 

11 1 11 


Size 

Status 

Identifier 


PC 


V 

Omitted for Output-Only Lines 

Polling List for TWX (AT&T 33, 35) Lines: 

1 1 1 

n 

Size 

Status 

Identifier 

Computer I.D. Sequence 


v 

Omitted for Output-Only Lines 


LEGEND: 

Size: Indicates total length of polling list. 

Status: Indicates current status of the polling list: if non - zero, the list is active (the line can be 

polled [nonswitched line] or enabled [switched line] ). The status byte is initialized to X'01 1 
(active) when the POLL macro - instruction is assembled. 

Pointer^ through Pointer^ Represent the addresses, relative to the terminal table address, of the first 
byte of the terminal table entries associated with this list. 

Stop: Identifies the end of the polling list for a nonswitched line. Stop is X'0000' for polled lines and 
X'FE' for autopolled lines. 

Identifier: Identifies the polling list as being for a switched or autopolled line. The identifier is 
X'00' for switched lines, X'02' for autopolled lines with IBM 1030, and X'03’ for 
autopolled lines with IBM 1050, 1060, or 2740. 

PAj through PA n : Represents the polling addresses of the terminals attached to an autopolled line. 

Each address is made up of one character for IBM 1030 and of two characters for 
IBM 1050, 1060, or 2740. 

1^ through M Represents the index characters associated with the polling addresses. 

PC: Is a polling character to be sent to an IBM 1050 terminal that calls the computer on the line 
represented by this polling list. 

m : Is the number of characters in the CPU identification sequence. 

Computer I.D. Sequence: Is the sequence of characters to be sent to any TWX terminal that calls the 
computer on the iine represented by this polling list. For WTTA terminals, 
CPU Identification Sequence is the sequence of characters to be sent to a 
WTTA terminal during an identification exchange. 


Figure 34. Felling list Format 














First 8 bytes are not placed 
on direct-access queue 



Key BKEY 


Buffer 

Scheduler 

Priority 

BMPR 


Offset of terminal table entry from 
* beginning of terminal table. 


10/11 

12 

13 14 15 

16 17 18 

19 20 21 

22 23 24 

Source 

Key 

BSTO 


Message 

Address 

Next 

Segment 

Previous 

Header 

Next 

Header 


on DASD 

Link 

Link 

Link 


BMAD 

BSLK 

BMHD 

BMLK 


Segment 

Size 

BSSZ 



Stored Scan Printer BSPT 

Message Sequence Number (IN) 

Message Sequence Number (OUT) 


HEADER PREFIX 


Format of Buffer containing Header 

First 8 bytes are not placed 
on direct-access queue 

0 1 2 3 4 5 6 7 


TEXT (Optional) 



Key BKEY 


Buffer 
Scheduler 
Priority 
BMPR o 


Segment 

Size 

BSSZ 


mtvmx DTVT text 

v BTXT 


Format of Buffer containing Text 

Note: All DSECT names have the prefix IJLQ. 

* Significance of the bits in the BSTA byte is as follows: 

Bit Position Bit Name 

0 CANCEL 0 = Send or process message 

1 = Do not send or process message 

1 REROUTE 0 = Original copy of header 

1 = Duplicate copy of header 

2 EOB 0 = No EOB is present in any buffer position except the last 

I = An EOB is present in some buffer position other than the last 

(Presence or lack of an EOB in the last position does not affect setting of bit) 

3 SRVCD 0 = Message was not previously serviced 

1 = Message was previously serviced 

4 TRUNC 0 = Normal message 

1 = Message is generated thru ERRMSG marco 

5 PRIORITY 0 = Message sent without priority 

1 = Message sent with priority 

6-7 SEGTYP 00 = Header segment (Not last segment) 

01 =Text segment (Not last segment) 

10 = Header segment (Last segment) 

II = Text segment (Last segment) 


Figure 35« Formats of filled Euffers (nonaudio lines) 
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ftPPENEIX P: SUMMARIES OF O.TAM MACRO INSTRUCTIONS 



Operand 


Function of Macro Instruction 


Buffer Assignment- 

Polling List Definition 


Terminal Table Definition - 


Line Table Definition 


Word Table Definition- 


integer, length [,mmm] [,brbj 


filename, rln 


LINETBL entry [,n] 


Sub field OPTION 


Pol Iname POLL 


PROCESS [expedite]!], ARU] 




qtype, filename, rln, [adchars (opdata, ...). 

r CALL = kI^TcI / [ID = hexchars][, DEVADDR = SYSnnn] [, PRNTR = YES] 
LCALL = NONEJ 


enter,[n] [, OPCTL = chars] [, CP INTV = integer], 

r (aru i 1 

Lconf =/mixed" 


diskaddr, length 


Notes: 1. OPTION must directly follow TERMTBL macro instruction. 

2. TERMTBL must be the first of the macro instructions used to create a terminal table 

3. LINETBL must be specified before all LINE macro instructions used to create the 
audio line table 

4. WORDTBL must be specified before all WORD macro intructions used to create the 
7772 DCV word table 



Figure 36* Summary of Control Information tfacro Instructions 
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Operation 


Operand 


i - + - 


LCGSEG 


MSGTYPE 

OFCTL 

PAUSE 

PCITIMIT 

REPEAT 

REROUTE 

ROUTE 

SEQIN 


ARUNGTYF 

j ttypechar] 

l 

EREAKCFF 

1 

| nnnnn 

i 

CANCELM 

1 

| irask 

i 

CEECKARU 

1 

| mask 

i 

COUNTER 

1 

| sufcfield 

i 

DATESTMP 

1 

i 

1 

DIRECT 

| r=CInn f dest 
| (sutfield 

i 

ECA 

1 

| eoa 

i 

ECB 

1 

i 

i 

ECBIC 

1 

i 

ERRKSG 

i ( 

| mask, < 

1 l 

INTERCFT 

1 

| irask»sufcfie 


CLn* dest* 1 
subfield 
source 


(ARE | 
filename f ,(PREFIX 


f / ^^iressage* 
( msgchar 


( PRIORITY 
JCC1WERSE 


JCC1WERSE y [ f ccndchar] [, wrt60=code] 
) INITIATE ( 

' M.CE2260 J 

(typechar] 

CTINSG=irsgname , TEBM=terirnaire 
[ tf ALTERM=terninaire] r [INTRCPT=/YES\] 

l NO j 

ctlchar # insertchar 


BED 

sutfield 


ccdecbar 


mask, ( ^Cl^dest*) 
<sutfield } 


SOURCE 


Figure 37• Functional Macro Instructions and the Delimiter Each May Follow (Part 1 of 
2 ) 
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Operation 


Operand 



Figure 37. Functional Nacro Instructions and the Delimiter Each may follow (Part 2 of 
2) 


Operation ] Operand 

- + - 

ENDRCV | 


Restrictions 


EflESEEE 

LFS1AE1 


lpsname 


tnn r ] 

TERM= 

Cterirnarre lf ..) 


Required delimiter; must be the first macro 
instruction in an LPS. 


PCSIARE 


Required delimiter in an Audio LPS; must appear 
only once. 


PCSTRCV 


Required delimiter; must immediately follow the 
last cf the sequence of macro instructions that 
handle incoming messages. Only one POSTRCV may 
appear in an LPS. 


PCSTSEKE 


Required delimiter; must immediately follow the 
last cf the sequence of macro instructions that 
handle outgoing messages. Only one FOSTSEND may 
appear in an LPS. 


RCVKER 

RCVSEG 

SENEKER 

SERESEG 


Figure 38. Summary cf Line Procedure Specification Delimiter Macro Instructions 
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AFPENEIX C: SAMPLE MESSAGE CONTROL PROGRA MS 


Two sample message control programs are 
provided: the first concerns a nonaudio 

application* the second concerns an audio- 
only application. 


NCNAUEIC SAMPLE ME£ SAGE CONTROL PROGRAM 


The following sample message control 
program is included to illustrate a method 
of arranging the source statements required 
to generate a message control program. The 
sample program performs the simple function 
of switching messages between two remotely 
located terminals. Ihe following equipment 
and options are required to support the 
program: 

1. Eisk: IEM 2311 preformatted for QTAM 
(S¥S005). 

2. Terminals: two IBM 1050s with the 
line correction feature. 

3. Telecommunications Control Unit: IEM 
2701 connected to the multiplexor 
channel of the IEM System/360. 

4. line configuration: one ncnswitched 
line (SXS0Q6) with two data sets (data 
path between terminals and the 2701). 


Input: Any data that can be sent by a 1050 

terminal is acceptable as, input . Messages 
may be of any length and may consist of any 
number of blocks. The last block of a mes¬ 
sage should be followed by an EOT character 
for maximum efficiency (otherwise a timeout 
will occur). No message header is neces¬ 
sary because the DIRECT macro is used to 
route messages* and no LPS macro instruc¬ 
tions that process header fields are 
included. 


Output: The message data, received from one 

terminal is sent to the bther terminal ~~ 
unchanged . 

Two methods may be used to furnish the 
necessary DTF tables to the message control 
program: 


1. DTF tables and message control program 
assembled together. 

2. DTF tables assembled separately from 
the remainder of the message control 
program. 

Both methods are illustrated in this 
appendix. 
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ASSEMBLING THE DTF TABLES AND MESSAGE CONTROL PROGRAM TOGETHER 


If the DTE tables and the iressage control program are assembled together* the assemb¬ 
ly source deck is as follows: 


QTAMMCP START 0 
EASEREG EQU 12 

EALR EASEREG,0 INITIALIZE BASE REGISTER. 

USING * , EASEREG ESTAELISH ADDRESSABILITY., 

* THE FILE INITIALIZATION AND ACTIVATION SECTION 

* CONSISTS OF TEE FOLLOWING MACRO INSTRUCTIONS 


OPEN DISK,GRP 

♦ 

LA 13,SAVEAREA 

ENDREADY 

* 

* 

SAVEAREA DS 18E 


OPEN DASD-MESSAGE QUEUES AND 
LINE GROUP FILES. 

ADDR OF USER” S SAVE AREA., 
BRANCH TO QTAM LOGIC TO AWAIT 
1ST MSG. CONTROL RETURNS TO 
INSTRUCTION LABELED LPS. 

USER SAVE AREA. 


* THE CONTROL INFORMATION SECTION CONSISTS OF 

* THE FOLLOWING MACRO INSTRUCTIONS 


EUFFER 3,100,5*3 

* 

* 

* 

* 

TERMTBL NYCX 

* 

DEST OPTION CL4 

* 

* 

* 


ECST 

$ 

TERM 

I,GKE,1„E202E20B, 

(NYCX) 

NYCX 

TERM 

L,GFE,1„E402E40B„ 

(BCST) 

PCILIST 

POLL 

(ECST,NYCX) 



* 

* 


PROVIDES THREE BUFFERS OF 100 
BYTES EACH FOR THE QTAM BUFFER 
POOL. ALSO PROVIDES STORAGE FOR 
FIVE CCWS THAT QTAM GENERATES 
FOR SENDING IDLE CHARACTERS. 
SPECIFIES THE EXTENT OF THE 
TERMINAL TABLE. 

THE NAME AND LENGTH OF AN 
OPTIONAL SUBFIELD TO CONTAIN 
THE DESTINATION CODE FOR MSGS 
RECEIVED FROM EACH TERMINAL. 
DEFINES THE TERMINAL TABLE 
ENTRY FOR THE BOSTON TERMINAL. 
ENTRY FOR NYC TERMINAL. 
SPECIFIES THE ORDER IN WHICH 
THE TERMINALS WILL BE POLLED. 


* THE LPS SECTION CONSISTS OF THE FOLLOWING MACRO INSTRUCTIONS 


* 

LPS LPSTART TERM=(1050) 

RCVHDR 

* 

DIRECT CFST 

* 

* 

* 

* 

* 

♦ 

ENDRCV 

ECELC 

* 

* 

* 

* 

FOSTRCV 

* 

SENDSEG 

PAUSE X * 5B f , 13X 1 5E" 

* 

* 

* 


IDENTIFIES BEGINNING OF LPS. 
IDENTIFIES RECEIVE HEADER 
SUBGROUP. 

CAUSES INCOMING MESSAGES TO BE 
ROUTED TO THE DESTINATION SPECI¬ 
FIED IN THE OPTIONAL SUBFIELD 
OF THE TERMINAL TABLE ENTRY FOR 
THE ORIGINATING TERMINAL. MSGS 
FROM ECST ARE SENT TO NYCX 
THOSE FROM NYCX ARE SENT TO BCST 
END RECEIVE SUBGROUP DELIMITER. 
ALLOWS THE 1050 TERMINAL TO 
CONTINUE SENDING AFTER AN EOB. 
ALSO PROVIDES FOR UP TO TWO 
RETRIES IF A TRANSMISSION ERROR 
IS DETECTED. 

END OF THE RECEIVE GROUP OF 
THE IPS. 

SEND SEGMENT SUBGROUP DELIMITER. 
CAUSES 13 IDLE CHARACTERS 
(X* 5E *) TO BE INSERTED EACH 
TIME A NL CHARACTER IS DETECTED 
IN AN OUTGOING MSG. 
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* 

* 

* 

* 

* 

* 

ENDMCP 


ENDSEND 

ECEIC 


POSTSENE 


CLOSE GRP,DISK 


END SEND SUBGROUP DELIMITER. 
INFORMS QTAM TO CONTINUE SEND¬ 
ING UPCN DETECTING AN EOB. 

ALSO SPECIFIES UP TO TWO RETRIES 
IF A TRANSMISSION ERROR IS 
DETECTED. 

END CF THE SEND GROUP OF THE 
IPS. 

CLOSE FILES. 


EGJ 


TERMINATES MSG CONTROL PROGRAM. 


* THE FILE-DEFINITION SECTION CONSISTS OF THE 

* FOLLOWING MACRO INSTRUCTIONS AND PARAMETERS 

Col. 72 

DISK DTFQT TYFE=DA, 

DEVADDR=SYS005, 

ECJAE=ENDMCP 

GRP DTFQT TYPE=IG, -* 

LINELST=<006), - 

SWITCHING, 

EE\ICE=1050, 

CPCLL=(PCLLIST), 

EUFNC=3 W 

ACLCC=17„ ^ 

CLPS=LPS t , 

Col. 72 

CEBITS, 

CU=2701„ 

TYPEFLE=CMBND 
END QTAMMCP 


ASSEMBLING THE DTF TABLES SEPARATELY 


If the DTF tables are assembled separately from the main part of the message control 
program, it is the user's responsibility to include the necessary ENTRY and EXTRN state 
irents. The main program is assembled as follows: 


QTAMMCP 

START 

0 

BASEREG 

EQU 

12 


ENTRY 

IPS,, PCLIIST „ ENDKCP 


EXTRN 

DISK,GRP 


BALR 

EASEREG,0 


USING 

*,BASEREG 


OPEN 

DISK,GRP 


LA 

ENDREADY 

13,SAVEAREA 

SAVEAREA 

ES 

18F 


BUFFER 

3,100,5,3 


TERMTEL 

EHIL 

DEST 

OPTION 

Cl 4 

ECST 

TERM 

I,GRP,1,E202E20E,(PHIL) 

PHIL 

TERM 

I,GRP,1,E«02E40E,(BOST) 

PCLLIST 

POLL 

<EOST,PHII) 

IPS 

LPSTART 

1ERM=(1050) 


RCVBDR 

DIRECT 

BEST 


ENDRCV 

EOBLC 

PCSTRCV 

SENDSEG 

PAUSE 

X'5E*,6X*5E * 
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ENDSENE 

EOBIC 

PCSTSENE 

ENDMCF CLOSE GFP„DISK 

ECJ 

END CTAKMCP 


The DTE table fcr the DASD iressage 
queues file is asseirtled as follows: 

Col. 72 

DISK ETFQT TYFE=EA, X 

DEVAEEB=SYS005, X 

ECJ2E=ENDMCP r X 

SEPA£N=YES 

ENE 


The DTF table fcr the line group file is 
assembled as follows: 

Col. 72 

GPP ETFCT T7PE=LC- f LINELST=(006) ff X 

£fciTCH==NC,,DEVICE=1050 ff X 

CPCLL-(POLLIST),BEFNO=3, X 
AC1CC=17,CLPS=LPS,CPRI=S, X 
CU=2701,TYPEFLE=CMBND„ X 

SEPASR=YES 

ENE 

ENTRY statements are required in the 
main program for the names specified in the 
CPOLL and CLPS operands of the line group 
DTVQT macro, and in the ECJAD operand of 
the EASE message queues DTFQT macro. This 
enables the linkage editor to resolve these 
address constants at linkage edit time. 
EXTPNs are not required for these names in 
the DTF * s because V-type address constants 
are generated for them in the macro expan- 
sion if SEPA£M—YES is specified. 

An EXTPN statement must be included in 
the main program fcr the name of any separ¬ 
ately assembled DTF referenced by the main 


program. An ENTRY statement is not neces¬ 
sary in the DTF assembly because the macro 
expansion generates it as a CSECT name. 
Only the DTF sections can be assembled 
separately. The remainder of the user- 
written message control program must be 
assembled together. 


AUDIO SAMPLE MESSAGE CONTROL .PROGRAM 


The following sample message control pro¬ 
gram illustrates the source statements 
required to generate an audio message con¬ 
trol program. The following equipment is 
necessary: 

1. Audio Response Unit: IBM 7770 con¬ 
nected to the multiplexor channel of 
the IBM System/360. 

2. Audio Line configuration: two 
switched lines (SYS007 and SYS008) 
with two data sets (data path between 
switched network and the 7770). 

Input : Any data that can be sent by an IBM 

1001 is acceptable as input. The input 
message representing an inquiry may be of 
any length within the input buffer area 
specified for a line. 

Output : The output message representing 
the audio answer is sent to the same termi¬ 
nal connected on line. 
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ASSEMBLING TEE ETE ANE MESSAGE CONTROL PROGRAM TOGETHER 


In this case, the assembly source deck is as follows: 


AQTAMMCF START 0 

BASJFRFG EQU 12 

EALR EA£EREG,0 INITIALIZE BASE REGISTER. 

USING *,EA£EREG ESTAELISH ADDRESSABILITY-* 


* THE FILE INITIALIZATION ANE ACTIVATION SECTION 

* CONSISTS OF THE FOLLOWING MACRO INSTRUCTIONS 


OPEN ARULG 

LA 13 # SAVEAREA 

ENDREADY 

* 

* 

SAVEAREA DS 18F 


OPEN 7770 LINE GROUP FILE,. 

AEDR CF USER SAVE AREA. 

BRANCH TO QTAM LOGIC TO AWAIT 
1ST MESSAGE. CONTROL RETURNS TO 
INSTRUCTION LABELED ARULPS. 

USER SAVE AREA. 


* THE CONTROL INFORMATION SECTION CONSISTS OF 

* THE FOLLOWING MACRO INSTRUCTIONS 


TERMTEL AMFF,CCNF=ARU 

* 

AMPP PROCESS ,ARU 

* 


SPECIFIES THE EXTENT OF THE 
TERMINAL TABLE. 

DEFINES THE PROCESS*PROGRAM 
ENTRY USED BY THE AUDIO LINES 


LINFTEL LINE2 

* 

LINE1 LINE ARULG,1 

* 

LINE2 LINE ARULG,2 


SPECIFIES THE EXTENT OF THE 
AUDIO LINE TABLE. 

DEFINES THE LINE TABLE ENTRY 
FOR THE FIRST LINE. 

ENTRY FOR THE SECOND LINE, 


* THE ARU/LPS SECTION CONSISTS OF THE 

* FOLLOWING MACRO INSTRUCTIONS 


ARULPS LPSTART TERM=(7770) 
TRANS RCVARU 

* 

REPEAT C * A * 

* 

* 

* 

FCSTARU 

ENDAMCP CLOSE ARULG 
ECJ 

* 


IDENTIFIES BEGINNING OF ARU/LPS 
CAUSES AUDIO INPUT MESSAGES 
TO EE TRANSLATED FROM ARU CODE 
INTO EBCDIC. 

CAUSES THE REPETITION OF THE 
PREVIOUS ANSWER, IF ANY, WHEN 
THE FIRST CHARACTER OF THE 
INPUT MESSAGE IS A. 

END CF THE ARU/LPS. 

CLOSE 7770 LINE GROUP FILE. 
TERMINATES MESSAGE CONTROL 
PROGRAM. 


* THE FILE-DEFINITION SECTION CONSISTS OF THE 

* FOLLOWING MACRO INSTRUCTIONS 

Col 


ARULG ETFQT TYFE=LG„ 

LINEL£T=(007,0C8), 

00=7770, 

CLFS=ARULPS, 

PRCCFSS=AMPP„ 

ECJAD=ENDAMCP # 
EUFIN=20„ 

BUFAC=50 W 

CMCEE=CVR, 

TYFEFIE=CMEND 

END A.QTANMCP 
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ASSERELING THE ETE SEPARATELY 


If the DTE tahle is assembled separately 
froir the main part cf the message control 
program, it is the user B s responsibility to 
include the necessary ENTRY and EXTRN sta¬ 
tements. The main program is assembled as 
follows: 

AQTAKNCP STABT 0 

EASEREG EQU 12 

ENTRY ARULPS* AMFP , ENDARCP 

EXTBN ARUJ G 

BALB EASEREG* 0 

USING * f BASEREG 

OPEN ABUIG 

LA 13* SAVE ARE A 

ENBREADY 

SAVEAREA ES 18F 

TERRTBL AKPP*CONF=ABU 
ARPF PROCESS ,ARU 

LINETBI IINE2 

LINE1 LINE ARULG,1 

LINE2 LINE ABULG 9 2 

ABULPS LPSTABT TERM=(7770) 

TRANS RCVARU 

REPEAT C B A B 

PCSTABU 

ENDAJySCF CLOSE ABULG 

EOJ 

ENE AQTAMMCP 

The DTF table for the 7770 line group is 
assembled as fcllcws: 

Col. 72 


ENTRY statements are required in the 
main program for the names specified in the 
CLPS, PROCESS and ECJAD keyword operands of 
the 7770 line group DTFQT macro. This 
enables the linkage editor to resolve these 
address constants at linkage edit time. 
EXTRNs are not required for these names in 
the DTF because V-type address constants 
are generated for them in the macro expan¬ 
sion if SEPASM=YEL> is specified. 


An EXTRN statement must be included in 
the main program for the name of any separ¬ 
ately assembled DTF referenced by the main 
program. An ENTRY statement is not neces¬ 
sary in the DTF assembly because the macro 
expansion generates it as a CSECT name. 


Only the DTF sections can be assembled 
separately. The remainder of the user- 
written message control program must be 
assembled together. 


ARULG DTFQT TYPE=IG, * 

LINELST=(007 w 008)„ * 

CU=7770 f CLPS=ARULFS ir * 

PRCCE££=AMPP* * 

ECJAE-ENDAMCP„ * 

EUFIN=20*BUFAC=50 ( , * 

CRCEE=CVR»TYPEFLE=CMBNE f * 
SEFASR=YES 

END 
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APPENEIX D: QTAM REGISTER USAGE IN THE IPS (CR AUDIO IPS) 


Certain of the registers vised by £TAM 
may be of value tc the user who writes 
closed routines (or in-line instructions) 
to be included in an IPS or an ARU/LFS. 
The usage of each cf these registers is 
explained below. Ecr an Audio IPS only 
registers 4, 7, and 13 are significant. 


Register 4 -- ICE cr ALCE Address Register 


Contains the address of the line cr 
audio line control block for the line over 
which t:he current iressage segirent was 
received (input IES or Audio IPS proces¬ 
sing) cr sent (cutput IPS processing). 


Register 5 — Scan Pointer Register 


The address of either the last character 
of the last header field scanned, or the 
first blank character following the field, 

1, If the operand cf the last macro that 
referenced a header field either does 
net permit any variation in the length 
cf the field (fer example, EOA C'A'), 
cr specifies explicitly the length cf 
the field (fer example, SOURCE 6)„ 
then register 5 contains the address 
cf the last character of the field, 

2, If the operand cf the last macro that 
referenced a header field does net 
explicitly specify the length of the 
field (fer example* SOURCE [no 
operand]), register 5 contains the 
address cf the first blank character 
that follows the field. 


Register 6 — Buffer Address Register 


Contains the address of the buffer cur* 
rently being processed by the IPS, If the 
buffer contains a header segment, the first 
data character in the header is located 32 
bytes beyond the buffer address. If the 
buffer contains a text segment, the first 
data character is located 22 bytes beyond 
the buffer address, Both offsets are rela- 
tive to register 6 as the base register. 


Register 7 — LPS or Audio IPS Base 
Register 


Contains the address of the beginning of 
the LPS or the ARU/LPS currently being 
executed (that is* the address of the first 
instruction of the LPSTART macro expan¬ 
sion). LPSTART establishes this register 
as the base register for this LPS. 


Register 8 — Terminal Table Register 


Contains the address of an entry in the 
terminal table. The particular entry 
depends on whether the Receive or Send 
group of the LPS is being executed. 

1. Receive Group . The address of the 
terminal table entry for the terminal 
from which the message segment cur¬ 
rently being processed was received if 
the terminal is on a nonswitched line. 
If the terminal is on a switched line, 
register 8 points to the beginning of 
the terminal table unless a SOURCE 
macro is included in the LPS, After 
SOURCE (if used) is executed* register 
8 contains the address of the terminal 
table entry for the originating 
terminal. 

2. Send Group . The address of the termi¬ 
nal table entry for the terminal to 
which the current message segment is 
being sent. 


Register 9 -- End-of-Segment Address 
Register ~~ ~~ 


Contains the address of the last charac¬ 
ter position in the buffer currently being 
read into or out of. 


Register 13 — Save Area Register 

Contains the address of a QTAM-provided, 
18-word save area to be used for saving the 
registers by a user-written routine.. 
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APPENDIX S: QTAM TERMINAL CODES 


This appendix contains charts which 
define the character sets and transmission 
cede tit patterns used hy the various ter¬ 
minals supported ty £TAM. Charts are also 
provided which facilitate reading the ter¬ 
minal code found in storage. 


QTAM CBARACTER SET AND CODE CCPFESPCNDENCE 
CHAFT 


code presented in column 3„ for ease of 
reference. 

In the EBCDIC group, the bit patterns 
and characters are arranged in collating 
sequence,, from hexadecimal 00 to hexadecim¬ 
al FF. In the remainder of the chart,, the 
locations of bit patterns and characters 
are determined by the arrangement of the 
translate tables. 


This chart shews the character set and 
bit patterns for the Extended Binary Coded 
Decimal Interchange Cede (EECEIC) and the 
character sets and transmission code bit 
patterns for each of the terminal types 
supported by DCS QTAM. 

The chart may he used to determine the 
bit patterns (as contained in main storage 
bytes) for each of the various characters 
sent or received by a specified terminal 
type; c.nd to determine the relationship (as 
established by the arrangement of the IEM- 
provided translate tables) among the char¬ 
acter sets for the various terminal types. 

For convenience in referring to particu¬ 
lar chart locations, the chart 8 s columns 
and rows are given reference numbers. Com¬ 
bined, these numbers enable reference to a 
particular chart location. For example, 
location 21/17, the intersection of row 21 
and column 17, contains NL. 


Arrangement of Chart 


Terminal Character Sets 


This chart shows only the characters 
comprising the commonly used character set 
options. The options represented in the 
chart are: 


IBM 1050: System/360 option 
IBM 1060: Standard option 
IBM 2260: Standard option 
IBM 2740: Standard option 
IBM 7770/7772: Standard option 
AT&T 83B3: A and C options 
WU 115A: A and C options 
WU TWX: Standard option 
WTTA: Standard option 


IBM 1030 graphics and ATST 83B3/WU 115A 
graphics that differ for the respective 
options are indicated in the chart by S and 
and A and C, respectively. Graphics not 
so marked are the same in both options. 


The chart contains a group of three 
columns fer the EECEIC character set and a 
group for each of the various terminal 
character sets. ftithin the EECEIC group, 
column 3 contains the 256 bit patterns com¬ 
prising the code. For those bit patterns 
to which characters are currently assigned, 
the characters appear in column 1 (gra¬ 
phics) and column 2 (line controls and 
device controls), (All currently assigned 
characters are shewn, regardless of whether 
they are in the character sets cf any of 
the terminal types represented in the 
remainder cf the chart). 

Each cf the remaining groups (columns 
4-36) contains the characters comprising 
the character set cf a specific terminal 
type, rlong with the transmission code bit 
patterns. Column 37 repeats the EBCDIC 


Transmission Codes 


The notations in the code columns of the 
chart for the various terminal types repre¬ 
sent the System/360 byte bit pattern equi¬ 
valents of the applicable transmission 
codes. The applicable transmission codes 
are: 

IBM 1030: Perforated Tape and Trans¬ 
mission Code 

IBM 1050: Perforated Tape and Trans¬ 
mission Code 

IBM 1060: Perforated Tape and Trans¬ 
mission Code 

IBM 2260: IBM 2260 Transmission Code 
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IEM 2740s Perforated tape and trans¬ 
mission code 

IEM 7770/7772: Audio Response Unit 
Cede (ARU code) 

AT6T 83B3: 5-level Baudot Code 

WU 115As 5-level Baudot Code 

WU TWX: 8-level TWX Code 

WTTA: 5-level ITA2 code 

5-level ZSC3 code 


Representation of Characters and Bit 
Patterns 


Appearance of a character and its asso¬ 
ciated hit pattern in a character set sig¬ 
nifies that the appropriate IEM-provided 
translate tables effect incoming transla¬ 
tion (that is, translation of that charac¬ 
ter tc the correspcnding EBCDIC character), 
outgoing translation (that is, translation 
of the corresponding EBCDIC character to 
that character), cr both. Hew the bit pat¬ 
tern appears indicates which of these cases 
applies: 

1* Where the hexadecimal representation 
cf the hit pattern appears in brac¬ 
kets, only incoming translation is 
performed. 

2. Where in parentheses, only outgoing 
translation is performed. 

3. Where the kit pattern is net enclosed 
by brackets cr parentheses, both 
incoming and outgoing translation is 
performed. 

Eecause each unique bit pattern for a 
terminal character can be represented in an 
incoming translate table only once,, the 
character associated with the bit pattern 
can be translated to only one EBCDIC char¬ 
acter. The converse is not true, however. 
Any one transmission code bit pattern can 
be placed any number cf times within an 
outgoing translate table. Therefore, any 
number cf EBCDIC characters can be trans¬ 
lated to the terminal character represented 
by that bit pattern. 

Appearance of twe bit patterns opposite 
a single character signifies that the char¬ 
acter has both an uppercase and a lowercase 
bit pattern, and that both forms of the 
character are translated to the same EECDIC 
character. 

Example : The hit pattern of the KI 
character appears in location 21/9. Eoth 


the lowercase and uppercase bit patterns of 
this character are translated to the EBCDIC 
NL character when they appear in an incom¬ 
ing message. When an EBCDIC NL character 
appears in an outgoing message, QTAM trans¬ 
lates it to the lowercase form of the NL 
character. 

Where more than one EECDIC character 
requires translation to the same character 
in a terminal character set,, the terminal 
character appears an equivalent number of 
times in the column. (For example, loca¬ 
tions 0/26, 6/26, 7/26, 23/26 and 50/26 all 
contain the LTRS character.) 

Where a character appears in both the 
graphics and the controls columns for a 
terminal type, its function depends on 
whether it is sent when the line is in con¬ 
trol mode or in text mode. Depending on 
the type of terminal and the mode,, the 
character may perform a control function,, 
print as a graphic, or both. For details, 
see the reference manuals for the various 
terminal types. 


Nonequivalent Characters 


Designing the system to accommodate ter¬ 
minal types having different character sets 
and control functions has resulted in sev¬ 
eral instances where dissimilar characters 
have been equated in translate tables. 

This accounts for the appearance in certain 
rows of this chart of nonequivalent charac¬ 
ters; for example, in rows 3„ 38, and 50. 

In other instances, the same or similar 
functions have different names among the 
various terminal types; for example, HT and 
Tab in row 5 are equivalent, as are DEL and 
Rubout, in row 7. 

In a few instances,, terminals using the 
same transmission code have different mean¬ 
ings assigned to the identical bit pattern; 
for example, bit pattern 79 in the trans¬ 
mission code has the meaning PF for an IBM 
1050, and Subtract, for an IBM 1060. 


Substitutions 


Where blank positions appear in the ter¬ 
minal character set portion of the chart, 
there is no equivalent character for the 
EECDIC character or bit pattern at the left 
of the chart. Where these blanks appear, 
the SUB character is to be assumed (they 
were omitted to make the chart more read¬ 
able). That is, in each translate table 
that handles incoming messages, each posi- 
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tion representing an invalid transmission 
code tit pattern (that is, one not used by 
a character in the terminal's character 
set) contains the EECDIC code (3F) for the 
SUB character. In each translate table 
that handles cutgcing messages* 

1 . each position that represents an inva¬ 
lid EBCDIC hit pattern (a pattern to 
which no EBCDIC character has teen 
assigned), and 

2 . each position that represents a bit 
pattern for a character having no 
equivalent in the destination ter¬ 
minal's character set 

contains the transmission code hit pattern 
fcr a substitute graphic, Eor the IEM 1050 
and 2260, and the AT€T 83B3 and WU 115A, 
this substitute character is a colon (:). 
For the IBM 1030 and 1060, the VITA ter¬ 
minals and the WU TWX, it is a slash (/). 


General Notes 


1. Standard abbreviations are used to 
represent the control characters. The 
full names cf the characters are 
given. See the reference iranuals fcr 
the varicus terminals fcr descriptions 
cf these characters, 

2. "Circle" characters ( E , C * etc,) 
in the chart are alternate names for 
the characters after which they 
appear, 

3. Notes pertaining to specific charac¬ 
ters or tit patterns are indicated by 
superscript numerals next to the char¬ 
acter or bit pattern. The notes fol¬ 
low, and indicate the chart locations 
to which they apply. 

4. Most of the characters in the S and H 
character set options (1030) and in 
the A and C character set cpticns 
(83E3, 115A) are identical. Where 
they differ between the options, the 
translate tables favor the S option 
and the A option, as illustrated in 
the chart. If messages frcir an H 
option 1030 are sent only to another H 
option 1030, the translate table may 
be used as is, and similarly* for the 
83B3/115A, with respect to the C 
option. If messages from terminals 
with the H or C option are to be 


exchanged with other terminal types,, 
the user may wish to modify the 
tables. 

5, Some TWX terminals send even parity 
transmission code bit patterns. 

Others send nonparity bit patterns. 

All bit patterns sent by nonparity 
machines have a 1 in the low-order bit 
position (that is, the position that 
serves as the parity bit in even pari¬ 
ty machines). The RCVTWX translate 
table translates either a nonparity or 
an even parity bit pattern to the 
EBCDIC bit pattern for the correspond¬ 
ing character. For those characters 
whose even parity and nonparity bit 
patterns are identical, a single bit 
pattern appears in Column 30 of the 
chart. For example, a single pattern, 
X'C3", appears in location 195/30. 

For those characters whose even parity 
and nonparity bit patterns differ by 
the setting of the low order bit* two 
bit patterns appear, as for example* 
in location 193/30. Where two bit 
patterns appear, the one enclosed in 
U is the nonparity bit pattern. The 
(] indicates that the nonparity bit 
patterns are only received from TWX 
terminals. In outgoing message trans¬ 
mission, the SNDTWXE translate table 
sends even parity bit patterns* while 
the SNDTWXC translate table sends non¬ 
parity bit patterns. 


Notes 


iLeft bracket translates to EBCDIC hex 79. 
No EBCDIC character has been assigned to 
this bit pattern (location 121/3* 

121/28). 

2 No graphic prints in the A character set 
option (location 90/25). 

3 Eackslash translates to EBCDIC hex El. 

No EBCDIC character has been assigned to 
this bit pattern (locations 225/3* 
225/28). 

"IBM 1030 sends the numeric 0 as a hex 20. 
1033 receives the numeric 0 as a hex 15 
(location 240/4). 

5 Right bracket translates to EBCDIC hex 49. 
No EBCDIC character has been assigned to 
this bit pattern (location 73/3* 73/28). 
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Control Characters 



EYP 

© 


can 

cc 



DC1 

DC2 

DC4 

DEI 

DIE 

DS 

EM 

ENC 

ECA 

ECE 

ECC 

ECFC 

ECM 

ECT 

ETB 

ETX 

FF 

FIGS 

FS 

HI 

IFS 

IGS 

II 

IFS 

IDS 

IC 


acknowledge 

End-cf-Elcck (same as EOE) 

Eell 

Backspace 

Eypass 

End-cf-Transmissicn (same as 

ECD 

Cancel 

Cursor Control 
Carriage (carrier) Return 
Machine End-o£-Address (same as 
ECA) 

Device Controls 
Delete 

Data link Escape 
Digit Select 
End of Medium 
Enquiry 

End-of-Address 

End-cf-Elcck 

End-cf-Card 

End-c£-First^Card 

End-cf-Message 

End-cf-Transmission 

End-Transmission-Block 

End-cf-Text 

Forms Feed 

Figures shift 

(EECDIC hex 22) Field Separator 
Horizontal Tabulate 
Interchange File Separator 
Interchange Group Separator 
Idle 

Interchange Record Separator 
Interchange Dnit Separator 
lowercase Shift 


LF 

line Feed 

LF-CR 

Line Feed-Carriage Return 

LTRS 

Letters shift 

MZ 

Minus Zero 

® 

Negative Response to polling*, 
addressing, or LRC/VRC 

Nan 

Nonacknowledge 

NL 

New Line 

NUL 

Null 

PF 

Punch Off 

PN 

Punch On 

PRE 

Prefix 

PZ 

Plus Zero 

RES 

Restore 

RM 

Record Mark 

RS 

(EBCDIC hex 35) Reader Stop 

© 

Start-of-address 

SI 

Shift In 

SM 

Set Mode 

SMI 

Start Manual Input 

SO 

Shift Out 

SOH 

Start-of-Header 

SMM 

Start Manual Message 

SOS 

Start-of-Significance 

SP 

Space 

STX 

Start-of-Text 

SDE 

Substitute 

SYN 

Synchronous Idle 

Tab 

Tabulate (horizontal) 

TM 

Tape Mark 

TpauxOff 

Tape auxiliary Off 

TpauxOn 

Tape Auxiliary On 

UC 

Uppercase Shift 

VT 

Vertical Tabulate 

WRU 

Who Are You? 

X-Off 

Transmitter Off 

X-Cn 

Transmitter On 

<t> 

Positive Response to polling*, 
addressing*, or LRC/VRC 
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EBCDIC 


IBM 1030 


IBM 1050 
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TERMINAL CODE TRANSLATION CHART 


This chart may te used in reading the 
teririnal code found in dumps of storage. 

The hexadecimal representation cf the ter¬ 
minal code, as found in a dump, is shewn at 
the side cf each section of the chart. 
Beneath the teririnal type is found the 
desired character to which the terminal 
code translates; also shown is the EBCDIC 
translation^ The programmer must determine 
if the hexadecimal cede in main storage 
represents EBCDIC (translated) cr terminal 
code (untranslated). 

Example : In order tc translate 

1601E4CC A5011515 150201CA B1E70190 


as found in a dump, the characters are 
first separated into pairs: 


16 01 E4 CC A5 01 15 15 
15 02 01 CA B1 E7 01 90 

If the terminal is an IBM 1050,, the chart 
shows that the characters in storage 
translate to 

EOA SP B O S SP 0 0 

0 1 SP N Y C SP * 

so that the message entered at the terminal 
was, in part, 

BOS 0001 NYC * 
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APPENDIX F: EXCHANGING MESSAGES BETWEEN IBM, AND NON-IBM TERMINALS 


This appendix is not applicable to audio 
message handling. 

Certain line and device control func¬ 
tions are implemented differently for IEM 
terminals and ncn-IEM terminals. General¬ 
ly, nc difficulties arise when messages are 
exchanged between IBM terminals of the same 
or different types, cr between ncn-IEM ter¬ 
minals of the same type. For applications 
in which messages are to be exchanged 
between non-IBM terminals of dissimilar 
types, cr between IEM and ncn-IEM ter¬ 
minals, the user should be aware of the 
considerations explained here, and plan his 
message headers accordingly. In some cases 
it is necessary tc edit certain characters 
or character seguences out of incoming mes¬ 
sages and edit certain characters or 
sequences intc cutgcing messages. The 
functions concerned are carriage return, 
line feed, end cf address, end cf block* 
end of transmission, and who are you? (the 
latter function applies to TWX and ViTTA 
terminals). 


End-cf-Address 


All QTAM-suppcrted IBM terminals employ 
a single machine end-of^address (EOA) char¬ 
acter, known as a D . Cf the non-IEN ter¬ 
minals* the 83E3 represents ECA by the 
sequence CR LF ITRS; the 115A represents it 
by a single space character? the TWX ter¬ 
minals have no ECA sequence; and WTTA ter¬ 
minals have nc machine ECA sequence. 

The first character in the message head¬ 
er sent to a Western Union Plan 115A termi¬ 
nal must be an ECA character (X*40 f before 
a TRANS macro instruction or X , 04* after a 
TRANS macro instruction). There must not 
be any excess idle characters preceding the 
ECA character. The QTAM user may ensure 
this by: 

1. reserving one more idle character in 
the message header, via the LPSTART 
macro instruction, in addition to any 
idle characters reserved fcr time-of- 
day, current-date, or output sequence 
number information? and 

2. moving an ECA character into the first 
data byte of the header (the thirty- 
second byte cf the buffer) in the Send 
Header subgroup of the IPS. If used 
before a TRANS macro instruction, this 
may be dene as fellows: 


MVI IJLQBHDR,X'40 f 

If used after a TRANS macro instruction* 

X° 04* should be inserted. 

If messages are to be switched from a 
non-IBM terminal to an IBM terminal, the 
user must edit out the received EOA charac¬ 
ter or sequence and insert the proper 
sequence for the receiving terminal. 

Figure 35 provides the code representations 
for the EOAs for each terminal type. 

For all IBM terminals except the 2740 
Types A and F , there may be two EOAs (two 
STXs for 2260) as the first two characters 
transmitted to the terminal. The first one 
is sent by the access method which sends 
the message to the terminal, while the 
second appears in core as the first charac¬ 
ter in the buffer (following idle charac¬ 
ters specified in the LPSTART macro¬ 
instruction). This second EOA was sent by 
the terminal as the first character in the 
message. 

The EOA character transmitted by the 
access method will perform its normal func¬ 
tion of putting the terminal in text mode* 
but the second EOA will print as a text 
mode character at the beginning of the mes¬ 
sage. The user may wish to insert the fol¬ 
lowing code to delete this character before 
transmitting the message: 

1(5),X* 7B* IS THIS EOA CHARACTER 
NO NO IT IS NOT 

1(5),X*17° YES, REPLACE WITH IDLE 
5*1(0*5) INCREMENT SCAN POINTER 


CLI 
BNE 
MVI 
LA 
NO . 


Carriage Return* Line Feed* New Line, and 
End-of-Block 


For non-IBM terminals, the carriage 
return and line feed functions are per¬ 
formed by two separate characters* CR and 
LF. For IBM terminals, the functions are 
performed by the single character* new line 
(NL).. A NL character in a message sent 
from an IBM terminal to a non-IBM terminal 
cannot be translated to two separate char¬ 
acters ? that is „ to both the CR and LF 
characters. To compensate for this* QTAM 
takes advantage of the usual practice of 
sending an EOB character at the end of each 
line of text printed on the printer of an 
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IE# terminal (that is* sending an EOE fol¬ 
lowed by a NIK Standard QTA# translate 
tables effect conversion of the EOB and NL 
characters to IF and CR* respectively* fcr 
messages sent from an IB# terminal tc a 
non-IE# terminal. Conversely* CR and LF 
characters sent by a non-IB# terminal are 
converted to ICE and NL characters* when 
the message is sent to an IE# terminal. 
Thus* as long as any messages originating 
from an IBM terminal always use the ECB and 
ML characters in combination* the carriage 
return and line feed functions at the 
receiving terminal (ncn-IEM) are effected* 
just as if the originating teririnal had 
entered CR and IF into the message* 


End-cf-Transmissicn and WRU 


All IBM terminals employ a single end- 
of-transmissicn (ECT) character* called a 
C * TWX terminals also employ a single 
ECT character. The 83B3 and 115A terminals 
represent ECT by the sequence FIGS H ITRS. 

An ECT in a message sent from an IEM cr 
TWX terminal to an 83E3 or 115A is trans¬ 
lated by QTA# to the two-character sequence 
FIGS H — (the ITRS character is not sent)* 
so the ECT sequence is not complete. The 
sequence is completed when QTA# deselects 
the terminal before polling the line or 
addressing a terminal on the line, When 
QTA# sends the ECT character that always 
begins a polling cr addressing cperation* 
the TCU first sends the ITRS character* 
completing the ECT sequence. The TCU then 
sends the complete ECT sequence FIGS B ITRS 


again. The EOT sequence thus appears on 
the receiving line twice* but this has no 
ill effect. 

The EOT sequence FIGS H LTRS sent from 
an 83B3 or 115A terminal to an IBM terminal 
appears in main storage as an upshift H 
(transmission code X f 25 f ). The TCU has 
deleted the LTRS character from the incom¬ 
ing data stream and converted the charac¬ 
ters FIGS H to the single character* 
upshift H. The upshift H is treated as an 
invalid character by the QTAM translate 
table; it is translated to a substitute 
character (X f 3F # * in EBCDIC). The user 
should edit this substitute character out 
of the message. When the message is sent 
to the destination IBM terminal* the user 
should edit into it the appropriate EOT 
character. Figure 39 provides the code 
representations for the EOTs for each ter¬ 
minal type. 

For messages sent from a TWX terminal to 
an IBM terminal,, the user must edit out an 
X-off character and replace it with an EOT 
character (so the terminal will not remain 
in text mode). 

The user must edit out all WRU charac¬ 
ters appearing in message destined for TWX 
terminal (DOS/QTAM does not support the WRU" 
function in outgoing messages to TWX ter¬ 
minals). The user should also edit out EOT 
characters appearing in messages destined 
for TWX terminals* because EOT will cause 
the terminal to disconnect from the line 
prematurely (that is* while QTAM is prepar¬ 
ing to send additional messages to the same 
terminal). See the section* Management of 
Nonaudio Switched lines . 


T~' -T--- 




Terminal Type 


| EGA Sequence | EOT Sequence | 


IE# 


2260 




All others 


Ncn- 

IEM 


83E3 


115A 


H 


Characters 


STX 


EOA ( © ) 


»- + -+- + -+ 


CR LF LTRS 




Space 


1 TWX 

- +- 

j WTTA 

t i I _ X 

j Note; Any character assigned by the user. 


Trans 

Code 

(hex) 


02 


16 


02081F 


04 


EBCDIC j Characters 
(hex) I 


02 j EOT (©) 


7B j EOT ( © ) 


-+--+“ 

0D2506 j FIGS H LTRS 


40 


I 


FIGS H LTRS 
EOT 


EOM 

EOT 


Trans 
Code j EBCDIC 

(hex) | (hex) 


04 


I 37 


IF 


I 37 
-+- 


H 


1B051F | 368806 

- +- 

1B051F | 368806 

21 1 37 

Note \ 37 

Note | 37 


-4 

I 

_j 


Figure 39. ECA and ECT Characters and Sequences 
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APPENDIX G: RETURN CODES FOR NETWORK CONTROL ^ACRO INSTRUCTIONS 


Upon return to the routine that issued adjusted, in register 15. All numbers in 
the macro instruction, the following return Figure 40 appear in hexadecimal notation, 
codes are set in the low-order byte, right- 


r --- T -T-T-T-T-T-T-T--- 1 

| Macro (NormalfUnopened(Invalid(Line not (Invalid |Invalid]Invalid Ter-|Invalid | 
| |Return|ETF (Disk (Inter- (Relative (Count |minal Table (Sequence j 

I | j jAddressjcepted |Line Numberj jEntry or DTF|Number j 

I I I I _ I I_ I _I Name | I 

| CHNGP |X*00' | X’01* | | | X’08' | X'10* | X’20' J | 

[ CHNGT |x*00* { { j j | X*10* | X*20' | j 

[ COPXC jx'OO* { X'01* { { { { j X* 20* { j 

I-4-4-4—-4->1-4-4--4-4 

| CCPXF |X*00' I X'Ol* I | | X* 08* | | X*20* | | 

\ CCPXC {x'00" { j { j~ j j X*20* { j 

I - -—4-4-4-4-4-—4-4—--4-4 

j CCPYT jx^OO* j j j j j | X* 20* j j 

4-4-4-4-4-4--—4-4---4~-4 

j STAR1ARU |X"00* j X*01* j | j X’08* j j X*20* j j 

I--4-4-4-4-4-4-4-4-4 

j STABTLN |X"00* | X*01* | | | X*08" | | X*20" | | 

[ STOEARU |x*00* { X*01« { { { X*08* { j X*20* | ] 

L_L_ X _J_ X _J_ X _ X _J_J 


Figure 40. Return Codes for Kacro Instructions Used to Modify and Examine System Status 
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APPENDIX H: FORMAT AND SUMMARY OF MACRO INSTRUCTIONS 


A format illustration accompanies each macro instruction description 
in this publication. The illustrations indicate which operands must be 
coded exactly as shown, which are required, which are variable* etc. 

The ccnventicns stated to describe the operands are as follows: 

1. Keyword operands are described by a three-part structure that con¬ 
sists of the keyword, followed by an equals sign (both of which 
must he coded exactly as shown), followed by either: 

• an uppercase keyword which must be coded as shown, or 

• a lowercase term which must be replaced by an allowable expres¬ 
sion as indicated in the chart or in the macro description* or 

• a combination of the above. 


Examples: TYPE^PC* CFCTL=chars, DEVAEDR=SYSnnn. Note that there are no 

blanks in the three-part structure. 

2. Positional operands are described either by: 

• a single uppercase term which must be coded exactly as shown* or 

• a single lcwercase term, which must be replaced by an allowable 
expression as indicated in the chart cr in the macro description. 

Example: SOURCE, filename 

3. Upper-case letters and punctuation marks (except as described in 
these conventions) represent information that must be coded exactly 
as shown. 

4. lower-case letters and terms represent information that must be 
supplied by the programmer. More specifically* n indicates a 
decimal number, nn a decimal number with at most two digits* nnn a 
decimal number with at most three digits, etc. 

5. An ellipsis (a comma followed by three periods) indicates that a 
variable number number of items may be included. 

6. \ ( Options contained within braces represent alterna- 

tives, one of which must be chosen. 


7. 


8 . 


A 

E 

C 


Information contained within brackets represents 
an option that can be included or omitted* depend¬ 
ing on the requirements of the program. 

Underlined elements represent an assumed value in 
the event a parameter is omitted. 
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Abbreviations Used in Foldout Chart 


Abbreviation 

SYN 

EEC DIG 

REGISTER 


BX type 

BEL EXP 

CHAB 

BEX CHAR 

B/S 


Meaning 

An X in this column indicates that the operand may 
be any symbol valid in the Assembler Language 

An X in this column indicates that the operand may 
be any decimal digits, up to the value indicated 
in the associated macro instruction description 

An X in this column indicates that the operand 
specifies a general register, always coded within 
parentheses, as follows: 

(2-12)- one of general registers 2 through 12, previously 
loaded with the right-adjusted value or address 
indicated in the macro instruction description. 

The unused high-order bits must be set to zero. 

The register may be designated symbolically or 
with an absolute expression, 

(1)- general register 1, previously loaded as indicated 
above. The register can be designated only as 
( 1 ), 

An X in this column indicates that the operand is 
coded as any address that is valid in an RX-type 
instruction (e.g,,LA), 

An X in this column indicates that the operand is 
coded as a relocatable expression (acceptable as 
an A-type or V-type address constant by the 
assembler). 

An X in this column indicates that the operand is 
coded as a character string, without framing char¬ 
acters and quotes. An F in this column indicates 
that framing characters, such as C* *„ CLn* % 
etc,, are coded. Refer to the macro description. 

An X in this column indicates that the operand is 
coded as a hexadeciaml character string,, without 
framing characters and quotes. An F in this 
column indicates that framing characters,, such as 
X* V, are coded. Refer to the macro description. 

An X in this column indicates that the operands 
are to be coded exactly as shown in the OPERANDS 
column. 
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MACRO 

INSTRUCTION 

OPERANDS 

ARUMGTYP 

typechar 

BREAKOFF 

nnnnn 

BUFARU 

n 


length 

BUFFER 

nnn 


length 


mmm 


brb 

CANCELM 

mask 

CHECKARU 

mask 


=X‘message 1 


msgchar 

CHNGP 

filename 


rln 


workarea 


1! 

n 

o 


=CT 

CHNGT 

termname 


workarea 

CLOSE 

filename 


COPYC 


COPYP 


COPYQ 


termname (nonaudio) 
rln (nonaudio) 
linename (audio) 
workarea 


Dec 
Sym Dig 


X 


X X 


X 


workarea 


termname 


workarea 


termname 



X X 


X 


X 


X 


X 


X 


WRITTEN AS 


RX Re 
Type Ex 



Flex 

Char 

Char 

F 

F 


MACRO 

INSTRUCTION OPERANDS 


=C Ln'dest 1 


subfield 


all operands 


DTFQT 


EOA 


ERRMSG mask 

CLn'dest' 

subfield 

SOURCE 

message 

msgchar 


INTERCPT I 


LINE filename 

rln 

LINETBL entry 


LPSTART 


MSGTYPE 


OPCTL 


COUNTER 


subfield 


entry 


filename 


,PREFIX (nonaudio) 


,ARU (audio) 


TERM= 


INTRCPT= 


PRIORITY 


CONVERSE 


INITIATE 


MOD2260 


condchar 


WRT60 :=: code 


typechar 


CTLMSG= 


TERM= 


MACRO 

INSTRUCTION 


OPCTL (CONT) 


OPEN 


OPTION 


PAUSE 


PROCESS 


REPEAT 


REROUTE 


ROUTE 


SEQIN 


SEQOUT 


SKIP 


SOURCE 


STARTARU 


OPERANDS 


,ALTERM= 


, INTRCPT 


fi lename 


typelength 


ctlchar 


rtchar 


codechar 


mask 


=C Ln'dest 1 


subfield 


SOURCE 


skipchrs 


fi lename 


rln 


ALL 


ctltbl 


WRITTEN AS 


Register 

Dec (2- RX Re I Abs Flex 

Sym Dig 12) (1) Type Exp Exp Char Char W/S 




Refer to Macro Description 


Refer to Macro Description 



X X 


MACRO 

INSTRUCTION 

OPERANDS 

STARTLN 

filename 


rln 

ALL 

ctltbl 

STOPARU 

fi lename 


rln 

ALL 

ctltbl 

TERM 

qtype 


filename 


rln 


adchars 

opda ta 

CALL= 

ID= 


DEVADDR=SYSnnn 


PRNTR=YES 

TERMTBL 

entry 


n 


OPCTL= 


CPINTV= 

CONF= 

TIMESTMP 

nn 

TRANS 

table 

WORD 

diskaddr 


length 

WORDTBL 

entry 


WTTA 

MACROS 



WRITTE 


Register 

(2- RX 

12) (1) Ty, 


Refer to Mact 


■■■■ 

HUM 

■Hi 


Refer to Macr 


Refer to Macr 


Refer to Macr 



Refer to Macn 









































































































































































































































































WRITTEN AS 


WRITTEN AS 



Sym 

Dec 

Dig 

Register 

RX 

Type 

Rel 

Exp 

Abs 

Exp 

Char 

Flex 

Char 

w/s 











F 

F 















X 

































X 











X 











X 


















F 











F 





■ 

■ 




F 

















X 










X 

X 











X 


X 































X 



X 








X 











X 



X 





udio) 






X 







X 









>) 








X 







■ 

X 










■ 


X 







X 












X 


X 









X 



X 








X 


X 









X 



X 








X 


X 


















MACRO 

INSTRUCTION 

OPERANDS 

Sym 

Dec 

Dig 

Register 

RX 

Type 

Rel 

Exp 

Abs 

Exp 

Char 

Hex 

Char 

w/s 


MACRO 

INSTRUCTION 

OPERANDS 

(2- 

12) 


DIRECT 

=C Ln'dest 1 








F 



OPCTL (CONT) 

, ALTERM= 

subfield 

X 










, INTRCPT 

DTFQT 

all operands 

Refer to Macro Description 

OPEN 

fi lename 

EOA 

eoa 


■ 

■ 


■ 

■ 


F 

F 


OPTION 

typelength 

ERRMSG 

mask 


■ 



■ 

■ 



F 


PAUSE 

ctlchar 

C Ln'dest 1 


■ 

■ 





F 



insertchar 

subfield 

X 










POLL 

entry 

SOURCE 










X 

AUTOPOL= 

message 


■ 

■ 





F 



pol laddr 

msgchar 





X 






nid 

INTERCPT 

mask 









F 


2740 

subfield 

X 

■ 

■ 


■ 

■ 





POLLIMIT 

nnn 

LINE 

filename 

X 










subfield 

rln 


X 









PROCESS 


LINETBL 

entry 






a 





REPEAT 

codechar 

n 


X 




■ 






REROUTE 

mask 

LIST 

entry 






D 





=C Ln'dest' 

LOGSEG 

filename 


■ 

■ 


■ 

K 





subfield 

,PREFIX (nonaudio) 

Refer to Macro Description 

SOURCE 

,ARU (audio) 

Refer to Macro Description 

ROUTE 

n 

LPSTART 

nn (nonaudio) 


X 









SEQIN 

n 

TERM= 

X 










SEQOUT 

n 

INTRCPT= 

X 










SKIP 

n 

MODE 

PRIORITY 




m 

■ 





X 

skipchrs 

CONVERSE 




m 

■ 

■ 




X 


SOURCE 

n 

INITIATE 










X 


STARTARU 

filename 

MOD2260 










X 

rln 

condchar 








F 

F 


ALL 

WRT60=code 

Refer to Macro Description 

ctltbl 

MSGTYPE 

typechar 








F 

F 




OPCTL 

CTLMSG= 








X 
















X 


TERM= 


X 



WRITTEN AS 

Sym 

Dec 

Dig 

| Register 

RX 

Type 

Rel 

Exp 

Abs 

Exp 

Char 

Hex 

Char 

w/s 

(2- 

12) 

(1) 









X 




X 













X 



X 












X 

■ 

■ 










■ 

F 



Refer to Macro Description 







X 






Refer to Macro Description 










X 











X 





■ 

■ 




■ 

■ 

X 



X 















X 






Refer to Macro Description 









F 

F 











F 










F 






■ 

■ 


X 















X 



X 











X 











X 






■ 





X 
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MACRO 

INSTRUCTION 

OPERANDS 

WRITTEN AS 

Sym 

Dec 

Dig 

Register 

RX 

Type 

Rel 

Exp 

Abs 

Exp 

Char 

Hex 

Char 

w/s 

(2- 

12) 

(1) 

STARTLN 

filename 



X 



X 





rln 


X 

X 








ALL 










X 

ctltbl 






X 





STOPARU 

fi lename 



X 



X 





rln 



X 








ALL 










X 

ctltbl 






X 





TERM 

i 

qtype 

Refer to Macro Description 

fi lename 






X 





rln 


X 









adchars 









X 


opdata 

Refer to Macro Description 

CALL= 

Refer to Macro Description 

ID= 









X 


DEVADDR=SYSnnn 










X 

PRNTR=YES 









■ 

X 

TERMTBL 

entry 






X 



■ 


n 


D 









OPCTL= 








X 



CPINTV= 


X 









CONF= 

Refer to Macro Description 

TIMESTMP 

nn 


X 









TRANS 

table 

X 










WORD 

diskaddr 


■ 

■ 

■ 





F 


length 







X 




WORDTBL 

entry 






X 





WTTA 

MACROS 


Refer to Macro Description 
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APPENDIX I: SUMMARY OF OPERATOR CONTROL MESSAGES 


CONTROL 

MESSAGE 

OPERANDS 

WRITTEN AS 

Dec 

Dig 

m 

S' 

Hex 

Char 

w/s 

CHNGT 

term name 


X 



data 



X 


COPYC* 

term name \ 


X 



> (nonaudio) 
rln ) 



X 


linename (audio) 


a 



COPYT* 

term name 


X 



INTERCPT 

term name 


X 



INTREL 

term name 


X 



STARTARU 

linename 


X 



ALL 




X 

STARTLN 

termname 


X 



ALL 




X 

STOPARU 

linename 


X 



ALL 




X 


* A response message is returned to the operator control terminal. 

Note : The Control Message ID (ctlmsg) is the same for all operator 

control messages. 

Figure 41. Summary of Operator Control Messages 
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APPENDIX J: PROGRAMMING CONSIDERATIONS FOR SPECIFIC DEVICES 


This section discusses certain device¬ 
dependent aspects cf prcgrainring. Scire of 
this iraterial may also be found elsewhere 
in this document; it is repeated here for 
the convenience of the prograirirer. 


framing: This discussion is not neces¬ 

sarily exhaustive: the programmer must 
still consider all aspects of his appli¬ 
cation carefully. 


IBM 1030 DATA COLLECTION SYSTEM 


Message Formats 


Format of message entered at terminal: 


| HEADER| TEXT| 
j.—//—JU//—^ 

j Characters j 
t~// //—* 


Format of message sent by message control 
program must be: 

First block: 

|HEADER | TEXT | 

h- t- x -T-^ 

|EOAj Characters j EOB j 
i-x- j-J 

Other blocks: 

]HEADER| TEXT ] 

[ -L— r — T - \ 

j Characters]ECB] 
l -x-J 

Notes: 

1. EOA is required only in the first 
block of a multi-block outgoing 
message, 

2, All printable characters ip an outgo¬ 
ing message toa 1033 printer must be 
separated by three Write Mark charac¬ 
ters (transmission code, X B DF S ) 

Idle Characters : The IBM 1033 Printer re¬ 
quires the insertion of three idle charac¬ 
ters (Write Mark) prior to each character 
transmitted to it. 


Fermat of message received by message con- IBM 1030 DATA COMMUNICATION SYSTEM 
trol program: 


Message formats (switched or nonswitched 
| HEADER | TEXT | terminals): 

j.- T _/ /—/—t -| 

| EGA|Characters j ECE| 

i„-X_//-//--1 J Format of message entered at terminal: 


Notes : 

1. ECA and EOE are automatically sent by 
the 1031 control unit when the termi¬ 
nal is polled and has requested to 
transmit. Because the terminal is 
polled for each block of a multi-block 
message, all blocks received by the 
message control program contain both 
ECA and ECE. 


|HEADER| TEXT 

1*—//-^//-T-T- ' / -T- 1 

j Characters | EOB ] Characters | EOB [-> 
V—//- //^ -X-//-X-J 


Q 


TEXT | 

r~-//—r- t- i 

Characters|EOB j EOT] 
l-//-.X X J 


2. Fcr autcpclled terminals, the ECA 
character is replaced by a 1-byte 
index. 


Note: It is usual practice to send EOB 

followed by NL when communicating with non- 
IBM terminals,, since QTAM translates EOB„ 
NL to CR,LF in sending to non-IBM 
terminals. 
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Format of message received by message con¬ 
trol pregram: 


| HEADER | TEXT 

[ -T—//-t-T- / -T- 1 

|EOA|Characters|ECE|Characters|ECB| 
-//--*//—---I-//--L-J 


f TEXT | 

Lr- ~ // -t- 

nCharacters|ECE|ECT j 
L-//-x- 4 --J 


Notes: 


1. ECA is automatically sent by the ter¬ 
minal when it is polled and has 
requested to transmit. Because the 
terminal is pclled for only the first 
block of a multi-block message, only 
the first block begins with EOA. 


2. Fcr autopclled terminals, the ECA 
character is replaced by a 1-byte 
index. 


Fermat of message sent by message control 
program must be: 


|HEADER | TEXT 

j.- T -//—“^—//— T -T-- T -1 

|EOA|Characters|ECE|Characters|ECB| 
L---L-//---//--*>-X-//-X- J 


Q 


TEXT | 

r -//- T - t- \ 

Characters j ECE j ECTj 
l -//^,-x-x-J 


Note: ECA is generated by the channel pro¬ 

gram for this device. 


Calls from the Computer to a Switched IBM 
1050 


After the computer establishes contact 
with an IBM 1050 cn a switched line*, QTAM 
sends the addressing characters specified 
in the terminal table entry fcr that termi¬ 
nal. When the terminal returns a positive 
response* QTAM sends all messages in the 
queue fcr that terminal. QIAN then sends 
the polling characters specified in the 
polling list for that line and accepts an 
incoming message frem the terminal if it 
has one ready. 

Ey turning the line around in this mann¬ 
er, QIAN allows the terminal to send during 
this connection all messages it may have 


ready,. After each incoming message ter¬ 
minated by an EOT (not to be confused with 
the EOT in a null message), QTAM sends any 
further messages that may have arrived on 
the destination queue for the terminal and 
then polls the terminal again. The proce¬ 
dure of accepting a message from the termi¬ 
nal and then sending any messages that 
arrive on the destination queue continues 
until: 

1. The computer receives a negative 
response to the poll; or 

2. The terminal sends a null message. 

That is, a single EOT is sent following 
the positive response to the poll. 

QTAM recognizes either of these as an 
indication that the terminal has sent its 
last message (or has no message to send). 
Note that one terminal is being repeatedly 
polled instead of a list of terminals being 
polled in turn. 

After all incoming messages have been 
received from the terminal, QTAM makes a 
final check to determine -if further mes¬ 
sages have arrived on the destination queue 
for the terminal. If so, the procedures 
for sending the messages and then polling 
the terminal for incoming messages are 
repeated during this line connection. When 
no further messages have arrived on the 
destination queue, QTAM breaks the line 
connection and reenables the line for its 
next use. 


IBM 1060 DATA COMMUNICATION SYSTEM 


Message Formats: 


Format of message entered at terminal: 

]HEADER| TEXT| 
j-//—X-//--J 

| Characters j 
L„//-//-J 

Format of message received by the message 
control program: 

|HEADER | TEXT 5 

f——//-X—/—J 

|EOA Characters|EOB| 

l„X„//-//-X-J 


Notes: 


1. EOA and EOB are automatically sent by 
the terminal when it is polled and has 
requested to transmit. Because the 
terminal is polled for each block of a 
multi-block message, all blocks 
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received by the iressage control pro¬ 
gram contain both EOA and EOB. 

2. For autopolled terminals, the ECA 
character is replaced by a 1-byte 
index. 

Fermat cf message sent by the message con¬ 
trol program must he: 

|HEADER | TEXT 1 

I* - t _//.X„//- t -^ 

IECAI Characters|ECE j 
t--W/- 

Note: Each outgoing message blcck must 

begin with EGA. 


IBM 2260-2848 EISEIAY COMPLEX (ICCAL) 


Message Formats 


Fermat of messages entered at the terminal: 

|HEADER | TEXT | 

j.-T ~/ /X -//t-^- \ 

j START \ Characters(ENTER j 
L-JL-//-.- //X -J 

Format of message received by the message 
control program: 

|HEADER| TEXT) 

[ -//—A—//—-j 

| Characters | 
l // //—J 

Note: A message received from an IEM 2260 

Local through a Read consists entirely of 
text. The transmitted text consists of all 
characters displayed between the START and 
ECM symbols, excluding any characters to 
the right of the first NL symbol on a line. 
There are no line control characters for 
this device. 

Fermat cf message sent by the message con¬ 
trol program must he: 

|HEADER| TEXT) 

t—//—■w/— 

j Characters | 
t—„// //—J 


Note: A message sent to an IBM 2260 Local 
through a Write consists entirely of text,, 
except when Write-with-line-address is spe¬ 
cified in the MODE macro instruction*, in 
which case the first byte must contain a 
line address code. The line address code 
is transmitted but not displayed. A zero 
length message is allowed and may be used 
with the ERASE/WRITE to effect erasure of 
the screen. 


Line Group Definition 


The requirements for defining an IBM 
2260-2848 Local line group are: 

• A DTFQT macro must be specified for 
each IBM 2848 Display Control. More 
than one 2848 ca,nnot be defined in the 
same line group. However, the same 
2848 can be defined in more than one 
line group. 

• No IBM 2260 DISPLAY Station or 1053 
Printer within the line group can be 
defined as part of another line group. 

• The same number of buffers must be 
assigned in advance for each transfer 
of data from a 2260 to the computer. 

• The same type of Read operation must 
be used Read Display Station ]DS[ 
Manual Input ]MI[ or Short Read DS MI 
for each 2260 in the line group. 

• The same LPS must be used for each 
device in the line group. 

• The relative position of the device 
access area in a terminal table entry 
must be the same for all terminal 
table entries associated with the line 
group (see the section. The Terminal 
Table). 


IBM 2260-2848 Local Operations 


QTAM supports the IBM 2260-2848 Display 
Complex (Local) attached directly either to 
the multiplexer or a selector channel. 
Figure 42 shows the configuration of a 
2260-2848 Local. 
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Selector Channel 



Note: The number of Display Adapters which may be 

included in a single 2848 Display Control varies. 

Figure 42. IEM 2260 local Configuration 


The 2260 Local terminal differs in 
operation from the other QTAM-supported 
devices. Because it is locally attached, 
the 2260 Local is neither polled nor 
addressed on input/cutput operations. 
Instead, when the operator at the 2260 
desires to send a message to the CPU, he 
keys in the STAB! symbol and text and then 
presses the ENTER key. Pressing the ENTER 
key results in a CPU I/C interrupt with the 
Attention bit on in the status. This I/C 
interrupt is referred to as an Attention 
interrupt or read request in this 
publication. 


When an Attention interrupt occurs at 
the CPU, a Command Control Block (CCE) for 
the 2260 initiating the read reguest must 
be in the DOS channel scheduler queue for 
the Attention interrupt to be honored. The 
CCE is a part of the terminal table entry 
for the 2260. If the CCB is not in the 
queue, the Attention interrupt is ignored. 


When a 2260-2848 Local line group is 
opened, QTAM causes the CCB for each 2260 
from which messages can be received to be 
placed on the channel scheduler queue. 

Each such 2260 in the line group must be 
defined in the list of terminals defined by 
the POLL macro instruction. After the line 
group has been opened,, read requests from 
the 2260s are serviced automatically on a 
first-come first-served basis. A message 
is read into buffers obtained from the QTAM 
buffer pool and then passed to the Receive 
Group of the user^s LPS section. Starting 
at this point, processing and further rout¬ 
ing of the message is the same as for a 
message received from a remote terminal. 

The procedures for sending a message to a 
2260 Lo cal terminal (or a 1053 Printer 
attached to the 2848) are the same as for 
sending one to a remote terminal except 
that addressing is not performed. 

Each time a transfer of data is com¬ 
pleted between the CPU and a 2260 Local*, 
QTAM causes the CCB to remain on the chan¬ 
nel scheduler queue if the 2260 is defined 
for input operations. This action antici¬ 
pates a subsequent read request from the 
terminal. 

Data transfer can occur between the CPU 
and only one 2260 Local at a time. For 
this reason,, only one Line Control Block 
(LCB) is generated for a 2260-2848 Local 
line group. This LCB contains control 
information required for I/O operations in 
the line group and for LPS processing of 
messages. Read requests (Attention inter¬ 
rupts) from 2260s may occur while the LCB 
is not available because of LPS processing 
of a previous message or because QTAM is 
preparing to send a message to a terminal 
in the line group. In such cases,, QTAM 
queues the read requests and services them 
as the LCB becomes available for receiving. 

Sending has priority over receiving for 
the 2260-2848 Local. That is, any time a 
message appears on the destination queue 
for the terminals in the group, it is sent 
before another receiving operation is 
initiated. 

The 2260 Local terminal is designed pri¬ 
marily for inquiry type applications,, where 
the operator enters an inquiry and then 
waits for a message processing program to 
construct and return a response. It also 
may be used for input only or output only 
applications. Message switching between 
two or more 2260s or between 2260s and 
other terminal types is not encouraged. If 
the operator of a 2260 attempts to enter a 
message while QTAM is preparing to send a 
message to the same terminal, his read 
request is ignored. The message sent by 
the CPU may obliterate the message the 
operator has prepared. When this occurs,,, 
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the operator irust key the message in again 
and reenter it via an ENTER- This condi¬ 
tion may occur frequently in a message 
switching application where message traffic 
is heavy. If message switching is neces¬ 
sary , it should he used infrequently and 
with caution. 

It has already keen noted that only one 
ICE is generated for a 2260-2848 Local line 
group. QTAMj treats a 2260-2848 local line 
group in basically the same way as it 
treats a one-line ncnswitched line group. 
When a function is being described that 
pertains to the 2260-2848 Local, it must be 
remembered that the word line applies to 
the entire line group. For example, the 
description cf the STCPIN macro instruction 
states that "STCPLN removes a line from 
active use." When this macro is used for a 
2260-2848 Local, the entire line group is 
stopped. 


DTFCT Macro Instruction 


The INTVL, CPRI, IINELST, and THRESH 
operands should be omitted. 


TERM yacro Instruction 


The EEVAEER operand for the TERM macro 
instruction must be specified (applies also 
to IEM 1053 terminals in a 2260-2848 local 
line group). PRNTR=yES must be specified 
if the terminal is an IEM 1053 terminal in 
a 2260-2848 Iccal line group. 


Polling List 


Cne and only one polling list must be 
specified for a 2260-2848 Local line group; 
it must contain the names of all IBM 2260 
Display Stations in the line group from 
which messages are to be received. A ter¬ 
minal must not appear in the list more than 
once. Messages are not accepted from 2260 
terminals not defined in the list. If the 
operator of an undefined terminal attempts 
to enter a message by pressing the ENTER 
key, the subsequent Attention interrupt is 
ignored. 

GTAM uses the polling list only at OPEN 
time, when the CCE for each 2260 Local ter¬ 
minal in the list is queued on the DCS 
channel scheduler queue in anticipation cf 
receiving a read request (Attention inter¬ 
rupt) from the device. Thereafter, the CCB 
is always maintained on the channel sched¬ 


uler queue except when QTAM is sending a 
message to the terminal. 


MODE Macro Instrction 


Note the applicable discussion under the 
MODE macro instruction. 


Translation 


The 2260 is an EBCDIC device; no trans¬ 
lation is necessary. 


Idle Characters 


The insertion of idle characters is not 
required. 


| IBM 2260-2848 OR 2265-284^ DISPLAY COMPLEX 
(REMOTE) 


Message Formats 


Format of messages to be entered at 
terminal: 

|HEADER | TEXT | 

y - T -//-X // T -j 

j START|Characters J ENTER j 

L-JL_//-//I-J 

Format of messages received by the message 
control program: 

|HEADER | TEXT | 

j.- T -//- J - //-T - A 

j STXj Characters j ETX] 
t. 1-//^ // ——J 

Note: Characters displayed to the right of 

the first NL symbol on a line are not 
transmitted. 

Format of messages sent by the message con¬ 
trol program must be: 

|HEADER } TEXT j 

I*- T —//--k-//-T —A 

j STX j Characters|ETXj 
t JL-// //-JL J 

Notes : 

1. For write-with-line-address, the first 
byte following the STX must contain a 
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line address cede, which is trans¬ 
mitted but net displayed. 

2. An SIX character is generated by the 
2260 Remote channel program for the 
beginning of a message. 


Operating the IEM 2260 


The high rate of data transfer from the 
CPU tc the 2260 Cisplay Station can cause 
the display screen tc be filled several 
times before the terminal operator has had 
time to read the initial display. Addi¬ 
tionally, a message sent to the Display 
Station obliterates any message being for¬ 
matted by the operator but not yet entered. 

If a 1053 Printer is attached to the 
2260-2848 Dispaly Complex (remote), mes¬ 
sages can be transferred directly from the 
display screen to the printer by simply 
pressing the Print key. However, if mes¬ 
sages are tc be sent from the CPU tc the 
printer, the user should either: 

1. Ensure that the previous message sent 
from the CPU to the printer and any 
message sent directly from a 2260 to 
the printer have been completely 
printed before sending another message 
from the CPU tc the printer; or 

2. Control the sending of messages from 
the CPU to the printer through the use 
of the INTERCFT and REIEASEM macros 
described in this publication. 


IBM 2740 COMMUNICATION TERMINAL 


274F: 

Basic 2740 with 
nonswitched. 

checking,, 

274G: 

Basic 2740 with 
switched. 

checking. 

274H: 

Basic 2740 with 
trol, switched. 

transmit con- 


Message Formats (274A and. 274B) 


Format of message entered at terminal: 

| HEADER | TEXT J 

I*-//-1//- T - i 

| Characters J EOT ] 
l-//-//~JL-J 

Note: The first EOB character encountered 

in incoming text is treated as an EOT char¬ 
acter, precluding transmission of any sub¬ 
sequent blocks of that message. 

Format of message received by message con¬ 
trol program: 

| HEADER | TEXT ] 

K-//-^//-r- i 

| Characters | EOT ] 

L-//-//-JL- J 

Note: No EOA character is received. 

Format of message sent by message control 
program must be: 

|HEADER | TEXT | 

j.—i 
j EOA j Characters]EOT] 

L-JU,//-//—4--J 


IBM 2740 Type Co d es. 


IBM 2740 terminal types are identified 
to the system (DEVICE operand of DTFQT 
macro instruction) by means of the follow¬ 
ing cedes. These cedes are also used in 
this section to identify the type of 2740 
terminal. 


Notes: 

1. EOA is generated by the channel pro¬ 
gram for this device,, 

2. The first EOB (or ETX) character 
encountered in outgoing message text 
is treated as an EOT character, pre¬ 
cluding transmission of any subsequent 
blocks of that message. 


274A: 

Basic 

2740, nonswitched 



274E: 

Easic 

2740, switched 

Messaqe 

Formats (274C) 

274C: 

Basic 

trol. 

2740 with station con- 
ncnswitched 



274D: 

Easic 2740 with station control 
and checking, nonswitched. 

Format 
Same as 

of message entered at terminal: 
for 274A and 274B 

274E: 

Easic 

2740 with transmit con- 

Format 

of message received by message con- 


trol and checking, switched. trol program: 
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| HEADER | TEXT | 

i - T -//-A„//- T - ^ 

IECA | Characters (ECT j 
L-A-//-//-A-J 


Notes: 

1* ECA is automatically sent fcy the ter- 
irinal when it is polled and has 
requested to transmit. Because the 
teririnal is polled for only the first 
block of a multi-block message„ only 
the first blcck begins with EOA. 

2. Ecr autopclled terminals, the ECA 
character is replaced by a 1-byte 
index. 


Eormat of message sent by message control 
program must be: 


(BEADEF | TEXT | 

j.- t -//-A—//- T - \ 

| |Characters|ECT| 

l -J—//-//-i-J 


Note: The first ECE (or ETX) character 

encountered in outgoing message text is 
treated as an ECT character,, precluding 
transmission of any subsequent blocks of 
that message. 


Message formats (274D, 274E, 274F, and 
274G) 


The formats of the messages for these 
terminals are the same as for the IEM 1050, 
with the following exception for the 274E 
and 274G: 

Fermat of message received by message con¬ 
trol pregram: 

|BEADEF| TEXT 

I*—// — A-// T - T -//- T - 

j Characters|ECE|Characters|EOE| 

L //-//A -A-//- A 


TEXT | 

r //-T T { 

|Characters|ECE|ECT| 
i //- a a j 

Ncte: No EGA character is received. 


Message Eormats (274B). 


The format of the messages fer this ter¬ 
minal is the same as for the 27 4A and 274B 


for messages entered at the terminal,, the 
same as for the 274C for messages received 
by the message control program, and the 
same as for the 274A and 274B for messages 
sent by the message control program.. 


DTFQT Macro Instruction 


For IBM 2740 terminals,, types 274A and 
274F, the CPRI operand of the DTFQT macro 
instruction should be omitted. 


Calls from Computer to a Switched IBM 2740 


After the computer establishes contact 
with an IBM 274 0 on a switched line,, QTAM 
sends a D and 15 idle characters followed 
by all waiting messages. QTAM then turns 
the line around to receive an incoming mes¬ 
sage in one of the following ways: 

1. For the IBM 2740 with transmit con- 
trol,, dial,, and checking or transmit 
control and dial* the terminal is 
polled with a / and a blank character. 

2. For the IBM 2740 basic with dial or 
dial and checking, the computer writes 
C C C followed by a Prepare. 

After each incoming message terminated 
by an EOT* QTAM sends any further messages 
that may have arrived on the destination 
queue for the terminal, and then receives 
from the terminal again. The line tur¬ 
naround procedure continues until the ter¬ 
minal operator presses the Dial Disconnect 
key. 


IBM 2740 ;MODEL 2 COMMUNICATION! TERMINAL 
DTFQT Macro Instruction 


The IBM 2740 Model 2 terminal is identi¬ 
fied to the system by the DEVICE operand of 
the DTFQT macro instruction as follows: 

DEVICE=274D if the terminal has the 
record checking feature; 

DEVICE—274C if the terminal is not 
equipped with the record checking 
feature. 
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TERM Macro Instruction 


The qtype operand of the TERR macro 
instruction should specify queuing by ter¬ 
minal for the 2740 Model 2 in order tc 
reduce unnecessary disk activity. 


INTERCPT Macrc Instruction 


If the terminal is equipped viith the 
Buffer Receive option, the user must speci¬ 
fy the INTERCUT iracrc instruction in the 
End Send section cf the LPS with a mask 
including the ^message not sent* bit. This 
is necessary because the terminal may be 
addressed while a message is being entered 
at the terminal, resulting in a negative 
response to addressing. If this happens, 
the terminal bell rings and the attention 
light is turned on. The intercepted mes¬ 
sage will be retransmitted when a positive 
response to addressing is received. 


Multi^block Messages 


The IEM 2740 Mcdel 2 is a single message 
block terminal. If the record checking 
feature is installed, the terminal expects 
to receive an ECE at the end of the message 
block transmission. The terminal then 
sends a positive response tc the Transmis¬ 
sion Control Unit and resets the terminal 
buffer address register to zero. The ter¬ 
minal then expects tc receive an EOT, which 
initiates printing. Therefore, if a multi¬ 
block message is sent to the terminal, only 
the last block is printed and no error con¬ 
dition is returned. 


Message Exceeding Buffer Size 


If a message sent to the IBM 2740 Model 
2 exceeds the size of the terminal buffer, 
the terminal returns an ECT to indicate a 
buffer overflow condition. The transmitted 
message is not printed at the terminal and 
an error message appears on the IBM 1052 
printer-keyboard or at the operator control 
terminal. The error halfword for the line 
has the 1 incorrect message length* and 
•should net occur* bits set. 


E QB or EQBLC Macro Instruction 


If the 2740 Model 2 is equipped with the 
record checking feature*, the transmission 
of EOB is a hardware function,. According¬ 
ly, either the EOB or the EOBLC 
macro instruction must be issued in the End 
receive and End send sections of the LPS. 


AUTOPOLLED TERMINALS - GENERAL 


The 1-byte autopoll index# received in 
place of an EOA character# should be 
replaced by an idle character (X # 17*) in 
the Receive Header portion of the user*s 
LPS after any code which uses that byte has 
been executed. 

If this is not done, the index byte may 
be identical to a control character causing 
an error in the QTAM Get routine or in a 
later sending operation. 

When receiving from an autopolled line, 
the source terminals identity is not known 
to the program. If knowledge of the source 
terminal is required, the user must use a 
source macro in the Receive Header section. 


IBM 3944 DIAL TERMINAL 


Output of messages from an IBM 3944 is 
in EBCDIC representation and requires no 
translation. 


ATST 83B3 SELECTIVE CALLING STATIONS 


Message Formats. 


Format of messages entered at the terminals 

| HEADER 1 TEXT | 

+ T*”'-T-/~ X //t ~T~T- i 

ICR j LF j LTRS j Characters!FIGS j HflLTRS4 

r „j. x.-+__//_//* -J 

j EOA j i EOT | 

Format of messages received by the message 
control program: 

| HEADER | TEXT | 

J.- T T //- X -// T - \ 

|CR j LF|Characters j Upshift H j 
---j 
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Note: The TCU has deleted the LTRS 

character frcir the input stream and 
converted FIGS H ITRE to the single 
character. Upshift B (transirission code 
X'25'). 

Fcrirat of messages sent by the message 
control program must he: 

| HI ALER | TEXT | 
j.— T — a// — x —//— 7 —4 
|CR|LF j Characters|ECT j 
l JL J.— X J 

Notes: 

1. The user should complete the EOA 
sequence by inserting CR LF LTRS. 

2. An EOT in a message sent from an IBM 
cr TWX terminal to an 83B3 is 
translated by QTAM to FIGS E. Since 
the LTRS character is not sent, so the 
ECT sequence is not complete. The 
sequence is completed when QTAM 
deselects the terminal before polling 
the line cr addressing a terminal on 
the line, when QTAM sends the ECT 
character that begins a polling or 
addressing operation, the TCU first 
sends the LTRS character, completing 
the ECT sequence. The TCU then sends 
the complete ECT sequence, FIGS H 
LTRS. 


TWX TERMINALS 
— - -- 


Message Formats 


Fermat of messages entered at the terminal: 

| HEALER J TEXT | 

I*-//—I//--T- i 

| Characters (End Character | 

*r// t-*’*/^ 

Notes: 

1. A CR in an incoming message from a 
non-IBM terminal is translated to ECB; 
thus these terminals can in effect 
transmit multi-block messages. 

2. An X-cff character will serve ns an 
end character. 

Format of messages received by the message 

control program: 

| HEALER| TEXT | 

t- //„a//„ t _---4 

| Characters |End Character | 

l-//-// -L-J 


Notes; 

1. If X-off is used as an end character 
and the message to be sent to an IBM 
terminal* the user should change this 
character to an IBM EOT character. 

2. An EOT character in a message received 
by a TWX terminal will cause the TWX 
line to disconnect. 

Fermat of messages sent by message control 
program must be: 

] HEADER| TEXT | 

f- //—*//—t--^ 

| Characters ]End Character | 
i // //—JL---J 

Note: An ECT in a message sent by a TWX 

terminal will cause the TWX line to 
disconnect. 


Calls from the Computer to a TWX Terminal 


After the computer establishes contact 
with a TWX terminal by dialing its 
telephone number* the terminal sends its 
identification sequence. QTAM checks this 
sequence against the sequence specified in 
the terminal table entry for the terminal. 
If they do not match, QTAM sets the MESSAGE 
NOT SENT bit (bit 12) in the error halfword 
for the line to indicate an addressing 
error* and breaks the line connection to 
the terminal (evidently* a wrong number was 
reached). 

If the two sequences do match* QTAM 
sends all messages currently on the 
destination queue for that terminal* then 
sends the CPU identification sequence 
(defined in the polling list for that line) 
to the terminal. The terminal then sends 
to the computer any messages it may have 
ready.. Each of these messages should end 
with a transmitter off (X-off) character. 
Each time a message terminated by this 
character is received* any further messages 
that have arrived on the destination queue 
for the terminal are sent. After these 
messages are sent (or if no further 
messages have arrived on the destination 
queue), QTAM again sends the CPU 
identification sequence and receives 
another message from the terminal. When 
the terminal has sent its last message, it 
should send an X-off character in response 
to the CPU identification sequence. When 
this character is the only character 
received from the terminal after sending 
the CPU identification sequence, QTAM 
recognizes it as an indication that the 
terminal has no more messages to send. 

QTAM then makes a final check to determine 
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if further messages have arrived on the 
destination queue for the terminal. If so, 
the procedures for sending these messages 
and then accepting incoming messages are 
repeated during this line connection. When 
no further messages have arrived on the 
destination queue, QTAM breaks the 
connection and reenables the line for its 
next use. 

Restriction : There is a possibility that 
scire message cn the destination queue for a 
TWX terminal will not be sent unless the 
line connection between the computer and 
the terminal is terminated by the computer. 
To avcid this possibility, an EOT (or any 
other character that causes the connection 
to be broken prematurely) should not be 
sent by the terminal nor appear in a x 
message being sent to the TWX terminal. 


WESTERN UNICN 115 A CUTSTATIQNS 


Message formats 


Format of message entered at terminal: 

| HEADER | TEXT | 

t ---T-//-- 1 —//-t-T- i 

|Space|Characters|EIGS H|LTRSj 

V -- - 1 - J 

j ECA j | EOT | 

Format of message received by message 
ccntrcl program: 

|HEADER | TEXT | 

J.- T -//_L_//_ t -H 

|Space(Characters|Upshift H | 

L-X—//-/✓—--J 

Note: The TCU has deleted the LTRS 

character from the input stream and 
converted FIGS H LTRS to the single 
character Upshift H (transmission code 
X* 25*). 

Format of message sent by message control 
program must be: 

|HEADER | TEXT | 

j.- T -/j 

|Space|Characters|ECT| 

L-X—//-//-X-j 

Note: An ECT in a message sent from an IBM 
or 5wx terminal tc a 115 A is translated by 
QTAM to FIGS H. Since the LTRS character 
is not sent* the ECT sequence is not 
complete. The sequence is completed when 
QTAM deselects the terminal before polling 
the line or addressing a terminal on the 
line. When QTAM sends the ECT character 
that begins a polling qr addressing 


operation* the TCU first sends the LTRS 
character* completing the EOT sequence. 
The TCU then sends the complete EOT 
sequence, FIGS H LTRS* 


WTTA TERMINALS 


WTTA Codes 


The WTTA adapter deletes all incoming 
LTRS or FIGS characters and updates a shift 
bit (S) which is added to each character 
transferred to main storage. The adapter 
examines the shift bit of each outgoing 
character and automatically generates a 
LTRS or FIGS character, whenever necessary. 
Figure 43 illustrates the configurations of 
a System/360 byte and of a WTTA character: 

[ojl^pTujslel?] System/360 byte 

i—i—i—i—i—i—i—i—4 

|x|xjs|l|2|3|4|5j WTTA character 

L—L—L—L—L—L_X—J—J 

Figure 43. System/360 byte and 

WTTA-^Character Configurations 

WTTA terminals use either the 
International Telegraph Alphabet No.2 
(referred to as ITA2) or the Figure 
Protected Code ZSC3 (referred to as ZSC3). 
These two codes are illustrated in Figure 
44 . 


Optional Features 


Normally, the motor of a WTTA terminal 
is off and the first LTRS character sent or 
received by the terminal starts the motor. 
The motor needs 1.5 seconds to reach 
nominal speed. During this interval* the 
terminal cannot correctly send or receive a 
character.* The motor stops when no 
character has been transmitted during a 
period of from 10 to 30 seconds. The 
terminal is said to be operating in 
Motor-Off mode. Optionally, the terminal 
can be equipped with a heavy-duty motor 
that is never switched off; in this case* 
the terminal is said to be operating in 
Motor-on mode. 

Most WTTA terminals can be equipped with 
another optional feature called the 
Automatic Answerback Unit. This feature 
enables a string of up to 20 identification 
characters, generated by a mechanical drum, 
to be sent over the WTTA line by either 
pressing the IAM key of the terminal or 
receiving the character FIGS D (combination 
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Nc, 4). Fcr terminals connected to a 2703 
Control Unit, the character string must he 
a multiple af four significant characters 
(i.e. excluding FIGS and LTRS). The last 
character of the identification 
character-string can he any character 
except ITRS or FIGS, This last character 
is not a significant part of the terminal 
identification. 

When a WTTA terminal is operating in 
Kotor-off mode, the KCNELY operand of the 
ETFQT macro instruction (refer to the 
section "ETFQT Kacrc Instruction") enables 
the user to specify the number of Mark 
characters corresponding to the 1,5-second 
interval mentioned ahove. When QTAM builds 
a Write channel program, it recognizes the 
motor mode of the terminal (motcr-on or 
motcr-cff) and generates a ITRS character 
(that can be followed by a user-specified 
number cf Mark characters) which precedes 
the data to be sent ever the WTTA line. 


Exchange of Identification 


Either the CFU or a WTTA terminal can 
ask fcr the identification sequence cf the 
ether. When an identification exchange is 
performed, the CEE sends its identification 
sequence to the terminal (IAK=YES must be 
specified in the ETFQT macro instruction),, 
and the terminal sends its identification 
sequence to the CFU (WRU=yES must be 
specified in the ETFQT macro instruction),. 
An identification exchange can he performed 
during either: 

1. Receiving eperations, each time the 
terminal operator sends the WRU siqnal 
to the CFU, or 

2. Sending operations,, at the beginning 
cf an output message (if the WRU macro 
instruction is in the Send Header 
suhgrdup cf the IPS) or at the end of 
an output message (if the WRU macro 
instruction is in the End Send 
subgroup of the IPS)• 

When the CFU receives the terminal 
identification sequence,, QTAM compares this 


sequence with that specified in the TERM 
macro instruction (refer to the section 
"TERM Macro Instruction"), 


End-of-Me?sage # End-oi; -Tra nsmissiQn,* and 
WRU for WTTA Terminals 


The World Trade Telegraph Adapter 
recognizes two end conditions which are set 
in the hardware at the time the control 
unit is installed. These are FIGS x and 
FIGS y LTRS* where x and y are characters 
assigned by the user of a specific system. 

For a terminal equipped with the 
Automatic Answerback Unit* FIGS x must be 
the code combination No, 4 (FIGS D) sent by 
the terminal WRU key. FIGS D is referred 
to as the WRU signal. For terminals not 
equipped with the Automatic Answerback 
Unit, any other code combination can be 
selected. 

Note 1 : x and y must not be the same 
character. 

Note 2 : The FIGS y LTRS sequence causes a 
Read operation to end. Therefore,, FIGS y 
can be sent by a terminal as data only if 
it is not followed by LTRS. 

The above termination signals can be 
used as EOM signals. Either the FIGS y 
LTRS sequence (if not yet used as an EOM 
signal) or two consecutive EOM signals can 
represent the EOT signal. 


Code Tables for World Trade Telegraph 
Terminals 


The following figures show,, for each 
character in each of the code sets used by 
World Trade telegraph terminals* the 
transmission code bit pattern corresponding 
to the character,, the code combination 
number representing that bit pattern,,, and 
the System/360 byte representation 
(including shift bit) of that bit pattern. 
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Letters Shift 


t--- T - 

| | S/360 

I I Eyte 

| Character | Eit 

|r- T ----j Pattern 

| Graphic j Ccntrcl j (Hex) 

l-- T — + -4- 


■ 

| Figures Shift 


+- 1 - 

| | S/360 

I I Eyte 

| Character | Bit 

- T --j Pattern 

j Graphic | Control j (Hex) 

■4—-+-+- 


| Trans- 
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j Code 
j Elements 
| 12 345 
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Code 
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A 

i 

i 
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1 

18 

i 
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i 

i 

1 

1 38 

i 

i 

11 

000 

1 

1 

1 

B 

i 

1 

13 

i 

? 

i 
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i 

10 

on 

1 

2 

C 

i 

1 

0E 

i 

: 
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01 
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D 
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E 
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10 
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10 
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1 

5 

F 
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1 

16 
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i 
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i 

10 
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1 

6 

G 
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1 

0E 
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i 

| 2B 

i 

01 
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01 

010 

1 

18 

s 

i 

1 

14 

i 

« 

i 

1 34 

i 

10 

100 
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19 
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Where no character appears opposite a code combination, no character has been 
assigned for that combination 




Figure 44, International Telegraph Alphabet No. 2 (ITA2) 
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Where no character appears opposite a code combination,, no character has been 
assigned for that combination 


Figure 45. Figure Protected Code (ZSC3) 
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APPENDIX K: ON-LINE TERMINAL TEST 


Nine tests are provided for IBM 1C30* 
1050# 1060# 2740, and 2260 (remote) 
devices. The integer associated with each 
test description is the code to be entered 
in the test field tc select that test for 
use. 


1 Message Switching. This test receives 
a message from the requesting terminal, 
and returns it tc the same terminal or 
tc any other terminal as specified in 
the addr field. 

Ncte: The number of characters that 

can be switched is directly dependent 
on the buffer length that the user 
specifies in the BUFFER macro 
instruction. If the total length of 
the test request message exceeds this 
length, the surplus characters in the 
test request message are ignored. 


2 Tilt . The tilt test is sent to the 
terminal specified in the addr field. 
This test is designed to check the 
SELECTRIC typing element. 

3 Rotate . The rotate test is sent to the 
terminal specified in the addr field. 
This test is designed to check the 
SELECTRIC typing element. 


4 Twist . The twist test is sent to the 
terminal specified in the addr field. 
This test is designed to check the 
SELECTRIC typing element. 

Ncte : The inability of the SELECTRIC 

typing element tc perform correctly the 
tilt, rotate, and twist tests is 
normally detected by observing 
partially printed characters within the 
pattern printed during the test. 


5 Stored Compar e. The text transmitted 
from the requesting terminal is 
compared with a stored message in the 
CPU. The message in storage is 
compatible with the transmitting 
capabilities cf the terminal(s) 
involved. The compare message sent 
from the terminal consists cf the 
numbers 0 through 9 followed by the 
alphabet (A through Z). The alphabet 
is entered in lowercase from an IEM 
1050 or an IBM 2740. 


Exceptions : 

1. When transmittal is from an IBM 

2740 terminal with station control, 
a space character must not precede 
the comparison data. When 
transmittal is from an IBM 2740 
terminal without station control,, 
two space characters must precede 
the comparison data. 

2* The stored compare test for an IBM 
1060 is requested by entering the 
following message: 

999996534210 TELLER A 
TELLER B 

Comparison is then made to this 
message. Response to this request 
is printed only at the requesting 
terminal. 

The number of characters that can be 
compared depends directly upon the data 
length of the buffer that the user 
specifies in the BUFFER macro 
instruction. The total length of the 
test request message must not exceed 
this length. 

If the comparison to the stored message 
is valid,, the following message is sent 
to the terminal specified in the addr 
field. 

CMP VLD-n 

where n is the last character against 
which a comparison could be made. If 
the data length of the buffer as 
specified in the BUFFER macro 
instruction is not great enough to hold 
all the message transmitted, the 
message is truncated after one buffer 
is filled and comparison is made only 
to the contents of that buffer. So 
long as the text content of that buffer 
is valid,, the comparison is considered 
valid. However, if the buffer length 
is so limited that no characters can be 
compared,, n is a slash (/). 

Exception : The message sent to an IBM 
1060 after a valid comparison is: 

CMP VLD 

If the comparison to the stored message 
is invalid, the data received is 
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message switched tc the teririnal 
specified in the addr field. 


where: 


DC + DV dcaddr dvaddr 


Ncte: The stcred compare test is not 

applicable tc the IBM 1030 badge reader 
or manual entry. 


6 all Characters . This is a standard 
all-characters test for customer 
engineer terminal checkout and for a 
"good morning" message for the user. 
Special characters are not used in this 
test. Characters received at the 
terminal are: 

1. For IBM 1030, 1060, and 2848 remote 
(2260 and 1053): numbers 0-9 and 
alphabet A^Z. 

2. For IBM 1050 and 2740: numbers 
0-9, alphabet a-z (lowercase), and 
alphabet A-z (uppercase). 


7 Carriage Mechanism Analyzer . A defined 
message in storage is used to exercise 
the terminal specified in order to 
analyze the capability of the 
typewriter carriage mechanism to 
perform within defined specifications. 
This test is not applicable to an IE# 
1053 printer attached tc a remote 2848 
control unit. 

8 Virite Line Address (2260 remote only) . 
This is a line selectivity test that 
uses the first two characters after the 
unit field (format 0) or the addr field 
(format 1) as a new line code. These 
characters can be followed by data that 
is tc be switched to the terminal and 
written on the line specified on the 
display station screen. The following 
characters are used to select the line 
on the display station screen: 

r- —t- 1 

|Characters|line Number| 

I--^- + -1 


01 

i 

i 

1 

09 

i 

9 

10 

i 

10 

11 

! 

11 

12 

1 

12 


u*_ jl _„_j 


9 Request Address (2260 remote on l y) . 

The addr and unit fields are not used 
in this test. ETX can be sent 
immediately after the type field. The 
message returned to the requesting 
display station is in the following 
format: 


dcaddr 

Is the predefined code necessary 
to select this display control 
unit (two bytes). 

dvaddr 

Is the predefined code necessary 
to select this display control 
unit (two bytes). 


FORMAT OF TEST REQUEST MESSAGE 


All fields of the test request message 
are consecutive. That is,,, they are not 
separated by blanks. The test message 
should not be preceded with a carriage 
return, space,, or any other character. 

If the total length of the test request 
message exceeds the size of a buffer as 
specified in the BUFFER macro instruction,,, 
the surplus characters in the test request 
message are ignored. 

The format of the test control message 

is: 

99999 format-integer 
test-integer type-integer 
[addr-char(s)] Cunit-char(s)] 
(text-chars] end-char 

where: 

99999 

Is the primary action code used to 
identify this message to the system as 
a test request message. This field 
must always appear exactly as shown in 
every test request message. 


format 

Defines the test header format. It is 
either 0 or 1. Format 0 uses actual 
line addresses and can be used to 
address any terminal on the same line. 
Format 1 uses symbolic addresses and 
can be used to address any terminal 
within the system. 

test 

Specifies the test to be executed. It 
is always one integer (1 through 9). 

type 

Specifies the type of terminal for 
which the test is being requested. 

Type codes that may be used are shown 
in the following table: 
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Terminal 

Type 

|Type Code 

IEM 1030 


T 

1 

1 

IEM 1050 


1 

1 

I 

2 

IEM 1060 


1 

1 

l 

3 

IEM 2740 


1 

1 

1 

4 

1 

IEM 1030 j 

Eadge reader j 

or Manual Entryj 

i 

5 

IEM 2260 R€itct€ 

1 

6 

Exception: 

Type 

_ 

code 

5 is 


with format 0, It defines the type of 
terminal requesting the test (as well 
as the type cf terminal for which the 
test is fceing requested). 


IBM 2260 remote devices* this field 
must consist of two characters. The 
address is selected by transmitting a 
predefined code as follows. 


1. IBM 1060: 


r ---- - --- 

| Terminal Address ]Code Entered 

i--—+- 



2, IBM 1030 Badge Reader or manual 
entry: 


addr 

The address cf the terminal 

1. To which a test message is to be 

sent (tests 1, 6, and 8)* 

2. At which a device to be tested 

mechanically is located (tests 2, 
3* 4, and 7), or 

3. To which a response message from 

the terminal-test facility is 
sent (test 5). (Test 9 does not 
utilize the address field.) 

Note : For the IEM 1050,, 1C60* and 

2260-2848 remote, two addressing 
characters are specified in the TERM 
macro instruction. For these devices* 
the first cf the two addressing 
characters is the actual address of 
the terminal, and is therefore the 
character to he specified in the addr 
field. The second of the two 
addressing characters specifies the 
particular device at the terminal, and 
is specified in the unit field. 

fchen used with format 0, this is one 
character or twc characters depending 
cn the type of device from which the 
test request message is being entered. 
It is a cne-character field for the 
IEM 1030 card reader, IBM 1050 
devices, and IEM 2740 devices* and is 
the addressing character fcr the 
selected terminal. Only one character 
is necessary because these devices are 
capable cf transmitting the actual 
alphabetic terminal address character. 

Fcr the IBM 1030 Badge Reader or 
manual entry, IEM 1060 devices* and 


r--- T ----i 

j Terminal Address jCode Entered | 


| B J 02 J 

1 C J 03 J 

| D j 04 | 

I ) • 1 

I I - I 

I 3 • I 

| Z J 26 I 

i------J 

Note: If 10 is entered as the 

addr field* the message is 
considered an invalid request 
because the corresponding address 
(J) is the address for the IBM 
1032 Digital Time Unit 
exclusively* for which no tests 
are provided. 


3. IBM 2260 remote devices: The addr 
field is used to select the IBM 
2848 Display Control Unit. The 
address of a display control unit 
can be any ASCII noncontrol 
character. Therefore, there are 
96 possible display control unit 
addresses. 


r - T _- - - 

Terminal Address ] 

in ASCII |Code Entered 


I*-————— 

—y—“ 


-1 

| 0100000 

:i 

01 


| 0100001 

i 

02 


| 0100010 

i 

03 


I « 

i 

. 


j 

i 

• 


1 « 

\ 

. 


1 1111111 

3 

_A-_ 

96 

_J 
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Note: The predefined code 
applicable to a particular display 
control unit can be determined 
from a display station by 
utilizing the request address test 
(test 9), 


When used with header format 1, 
this field is variable in length 
(form cne tc nine characters). 
The first character is a digit 
defining the number of following 
characters that constitute the 
symbolic address name. This 
symbolic address name defines a 
terminal in the terminal table. 


r~“-v---1 

| Device Selection ] | 


Character in 
ASCII 

1 

| Code 

Entered 

1000000 

¥-- 

1 

01 

1000001 

1 

02 

1000010 

i 

03 

o 

i 


• 

i 

• 

o 

i 

. 

1011000 

i 

25 

___ 




Note : The predefined code applicable 
to a particular display station can be 
determined from a display station by 
utilizing the request address test 
(test 9)o 


Examples : 

text: 

a. 4CBII (four-character symbolic 
name). 


h. 7CEICAGC (seven-character 
symbolic name). 

end 

c. 0 (a zero indicates that the 
test is to be returned tc the 
requesting terminal). 


The text of the message sent as a part 
of the terminal testo Text is 
included only when the message 
switching test (test 1)„ stored 
compare test (test 5), or write line 
address test (test 8) are used. 


The end character for the device from 
which the test request message is 
being transmitted. 


Note that terminal CRTI could 
request a test for itself by using 
either example a or c. 


unit 

Specifies the particular unit at the 
terminal specified in the addr field. 
This field is used only when the 
format 0 is specified. When format 1 
is used both the terminal and the unit 
at the terminal are defined by the 
symbolic name in the addr field. 

Ecr IBM 1050 and IEM 1060 devices, one 
character is specified. The 
appropriate cede can be determined 
from the publication describing the 
type of terminal being addressed. 

Note : This field is net applicable to 

IBM 1030 and IEM 2740 devices. 
Therefore, text can start in this 
position. 

Eor IBM 2848 devices, twe characters 
are specified. IBM 2260 Display 
Stations and IEM 1053 Printers are 
selected by transmitting a predefined 
cede. The device selection character 
can be any of 25 ASCII ncncontrcl 
characters. 


r- t 

| Device | 

j.-—+- 

| IBM 1030 I 
I IBM 1050 j 
j IBM 1060 j 
j IBM 2740 j 
j IBM 2260 j 

l- 


End Character | 


EOB 

EOT 

EOB 

EOT 

ETX 


Note : The header transmitted from an 

IBM 1060 device is entered by use of 
the data and transaction keys. The 
EOB character is entered by pressing 
the Teller A or Teller E key. 


TERMINAL TEST RESTRICTIONS 


1. The length of the buffer as specified 
in the BUFFER macro instruction must 
be at least 56 bytes in order to 
contain all the test request header 
(that is„ all the test request message 
before the text field) plus the header 
prefix inserted by QTAM. 

2. To request a test from an IBM 1030 
Badge Reader,, the badge reader must be 
wired to read out the entire ten 
columns of the badge. (Refer to the 
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appropriate publication on IBM 1030 
devices)• 

3. The transaction code received from IBM 
1030 devices is not included as part 
cf the test request. 

4. When header format 0 is used, all IBM 
1030 tests require an IBM 1033 Printer 
cn the saire line as the requesting 
terminal. The printer is specified in 
the addr field. 

5. The terminal tests will not test IBM 
1035 Eadge Readers or IBM 1030 Badge 
Readers in a 1035 environment. 

6. When switching messages from one 
terminal type tc another, the sending 
terminal must conform to the character 
set of the receiving terminal. 

7. A maximum of 39 characters can he 
switched tc an IBM 1033 Printer. 


8. To return a test to the requesting 

terminal on a dial line,, format 0 must 
be used and EOT must be sent within 
the first buffer. 


9. On an IBM 2740 basic terminal or 

terminals on a line using Auto Poll,, 
format 1 must not be used with a 0 in 
the addr field. 

10. All on-line terminal tests roust be 
completed before a closedown procedure 
is initiated (that is* before a 
CLOSEMC macro instruction is issued). 

11. Test messages qannot be canceled. If 
the test message has been entered 
incorrectly, the user should enter EOT 
and begin again. 

12. If format 0 is used on a line using 
Auto Poll, EOT must be sent within the 
first buffer. 
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APPENDIX L: ERROR INDICATORS 


CTAM indicates the occurence of an error ky setting bits in the error 
halfwcrd, for ncnaudic lines, or the error byte, for audio lines. The 
following defines the errors indicated by each of the bits of these two 
areas. A detailed explanation can be found: 

Cn page 83 * fcr ncnaudio lines 
Cn page 140 , fcr audio lines. 

The mask used tc test for each kit is indicated for each bit. Masks may 
also ke used to test for a combination of errors (for example* a mask of 
x*3000 # coded in the ERRMSG macro instruction tests for an indication of 
sequence number lew cr high). 


i 


Bit h 


h- 


Kccaudio Lines 


| yask 
. + - 


- T - 

I 

- 4 - 


Functicn 


0 

i 

X* 8000 * 

1 

i 

X* 4000 * 

2 

i 

X 1 ’ 2000* 

3 

i 

x’leoo 11 

4 

i 

i 

X " 0 8 0 0" 

5 

i 

X" 0400" 

6 

i 

X*0200* 

7 

i 

X*0100" 


T 


8 

1 

X - 0080° 

9 

l 

X"0040* 

10 

1 

X* 0020* 

11 

1 

X*’0010 w 

12 

1 

X* 0008* 

13 

l 

X 1 * 0004* 

14 

1 

X* 00C2 * 

15 

l 

X*0001 w 


Invalid destination 
Terminal inoperative 
Sequence number high 
Sequence number low 

Zero-length messages 
Incomplete header 
Invalid source 
Shculd-not-cccur 


Transmission error 
Timeout exceeded 
Ereakoff 

Insufficient buffers 
Message not sent 
Control Unit failure 
(Reserved for IBM use) 
(Reserved fcr IBM use) 


Audio Lines 


H 


Mask 

j Function 

± ^ _, 

3 

_II 

X - 80* 

T 

|Overlength message 

• 

3 

X' 40* 

[Repeat error 

3 

X* 20* 

[Read error 

1 


|(Reserved for IBM 

use} 


j only) 

1 

X* 08* 

[For user use 

3 

X* 04* 

[For user use 

3 

X* 02" 

|For user use 

3 

x*or 

[For user use 

3 

. 

-l --- 

_—j 


Figure 46. 


Line Error Indicators 
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GLOSSARY 


addressing : a procedure in which the 

computer transmits identifying characters 
to a terminal preparatory to sending a 
message tc that terminal. 

address chain : an ordered sequence cf drum 
or disk addresses which is the user w s 
response message. 

addressing characters : a set of characters 
peculiar to a terminal and the addressing 
operation; response tc the transmission of 
these characters indicates whether or not 
the terminal can receive a message. 

answering : a procedure by which a called 

party completes a connection (fcr switched 
lines). 

ARU cede : a 8-bit byte representation of 
the transmission code used by audio 
terminals other than IBM 3944 Dial 
Terminals. 

audio communication line (or audio line) : 
a communication line attached tc an audio 
response unit. 

audio line control block : an area of main 
storage containing control data for 
operations on an audic line. Abbreviated, 
ALCE. 

Audio line Procedure Specification : a line 
procedure specification (IPS) which only 
concerns the audic input messages. 
Abbreviated, Audic IPS. 

Audio Response Unit : an IEM 7770 or 7772 
control unit. Abbreviated, ARTJ. 

audio terminal : a terminal attached to an 
audio line via a switched network. An 
audio terminal accepts keyed or dialed data 
as input to be sent tc the computer, and/or 
produces an audio response as output 
received from the computer. 

buffer : a storage device or area used to 
compensate for a difference in the rate of 
flow of information, or the time of 
occurrence cf events. Buffers consist of 
irain-stcrage areas; size of the areas is 
designated by the user. 

calling : a procedure by which a first 
party attempts to establish a ccnnection 
with a second party through a central 
office exchange. Also, dialing. 

chain : the part cf a queue consisting of 
an ordered arrangement of items. The items 


are related to each other by links. One or 
more chains may exist in each queue. 

closed, routine (or subroutine) : a routine 
or subroutine that is not inserted as a 
block of instructions within a main routine 
but is entered by basic linkage from the 
main routine. 

communication line group : a group of lines 
with similar characteristics (such as 
association with the same type of terminal 
device). 

component : a point in a communications 
network at which data can enter or leave; 
an input/output device. A component is 
always attached to a terminal control unit. 

data collection : a telecommunications 
application in which data from several 
locations is accumulated at one location 
before processing. 

destination code : the name of a terminal 
or processing program to which a message is 
directed. 

destination queues, DASD : a group of 
queues in which the queue control block for 
each queue resides in main storage, and the 
message-segment chain for each queue 
resides on a direct access storage device. 
The queues contain message segments that 
are transmitted to terminals. 

dead-letter queue : a queue containing 
messages that could not be placed in the 
appropriate destination or process queue. 
The dead-letter queue begins in relative 
record address 0 on the direct access 
storage device used. 

DCV : abbreviation for Digitally Coded 
Voice. 

DCV vocabulary : an input vocabulary, 
supplied by IBM,, made up of DCV words and 
to be used by an IBM 7772 Audio Response 
Unit. 

DCV word : a word in DCV representation. 

delimiter macro instructions : LPS macro 
instructions that group functional macros 
into various coding subgroups. 

direct access queues : a group of queues, 
or, more specifically, message-segment 
chains of queues, residing on a direct 
access storage device. The group can 
include destination and process queues. 
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direct-connection line ; a line that 
carries messages directly to their 
destination point (that is, dees not go 
through a central office exchange); a 
leased line. 

distributicn-list entry : a teririnal table 
entry containing information on a group cf 
terminals, each cf which is to successively 
receive any message directed to the group. 
The information in the entry includes 
relative addresses that locate the single 
terminal entries for each terminal in the 
group. 

DTF table ; an area cf main storage that 
serves as a logical connector between the 
user*s problem pregram and a file. The ETF 
table can also be used to provide control 
information for any transfer of data. 

end-of-address character (machine) : a 
control character transmitted but not 
included with message data at the receiving 
location; the character indicates the end 
cf nen-message-data characters (for 
example, addressing characters). 
Abbreviated, FCA. 

end-cf-address character (program) : a QTAM 
character that must be placed in a message 
if the system is tc accommodate routing cf 
that message to several destinations; the 
character must immediately follow the last 
destination cede in the message header. 
Abbreviated, EOA. 

exchange, common-carrier : the location of 
a common carrier's communication equipment 
for interconnecting subscribers' lines. 

functional macro instructions : IPS macro 
instructions that operate on message 
segments and perform functions such as 
message editing, checking validity cf codes 
used in the header, routing messages to 
specified destinations, maintaining legs of 
messages, and checking for errors in 
transmission or specification. 

group-code entry : a terminal table entry 
containing information on a prespecified 
group cf terminals with the group code 
feature; this feature facilitates 
simultaneous transmission of a message to 
all members of the group through the 
specification of a single set of unique 
address characters. 

header : a part of the first segment cf a 

message containing information necessary 
fer directing the message tc its 
destination, and ether control information. 

line control blcck (ICB) : an area of main 
storage containing control data for 
operations on a line. The ICE can be 
divided into several groups of fields; most 


of these groups can be identified as 
generalized control blocks. QTAM maintains 
an LCB for each line in the system. 


Line Procedure Specifications : a sequence 
of user-selected macro instructions that: 

1. specifies the manner in which control 
information in the message header is to 
be examined and processed; and 

2. Specifies other functions (such as 
translating) to be performed. 

Abbreviated, LPS. 

log : a collection of messages that 
provides a history of message traffic. 

logging : the process of recording messages 

on a storage medium for purposes of 
maintaining a history of message traffic. 

LPS control routine : a QTAM routine that: 

1. performs initialization functions; and 

2. obtains the address of the LPS line 
group routine to be used for processing 
a particular message segment. 

LPS line group routine : a user-defined 
routine comprised of subroutines necessary 
to prepare a message segment for 
processing, and examine and process the 
control information in the message segment. 
The functions performed are based on the 
user-selected macro instructions that 
determine the configuration of each line 
group routine. One line group routine must 
be provided for each line group included in 
the system. 

message : a combination of letters, digits, 

and symbols whose termination point is 
marked by an end-ofr-transmission (EOT) 
character. 

message data : transmitted characters that 
are recorded as part of a message. A 
message data, area is the area in a buffer 
that receives message data. In QTAM, a 
message data area begins with either the 
thirty-second byte of a buffer (if the 
message data includes a message header), or 
with the twenty-second byte of the buffer 
(if the message data consists of text 
only). 

message segment : that portion of a message 
that fits in the message-data area of a 
buffer. 

message switching : a telecommunications 
application in which a message is received 
at a central location, stored on a 
direct-access device until the proper 
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outgoing line is available, and then 
transmitted to the appropriate destination* 


polling : a flexible, systematic, 

centrally-controlled method of permitting 
terminals on a multiterminal line to 
transmit without contending for the line. 
The computer contacts terminals according 
to the order specified by the user; each 
terminal contacted is invited tc send 
messages. 

polling characters ; a set of characters 
peculiar to a terminal and the polling 
operation; response to these characters 
indicates to the computer whether or not 
the terminal has a message to send. 

polling list : a list containing control 
information and names of entries in the 
terminal table; the order in which the 
names are specified determines the order in 
which the terminals are polled. 

process-program entry : a terminal table 
entry containing information on a 
processing program as the destination for a 
message. 

process queue f DASD : a queue in which the 
queue control blcck resides in main 
storage, and the message-segment chain 
resides on a direct access storage device. 
These queues contain message segments that 
are sent to a message processing program. 

processing collected data : an application 
in which the data accumulated through a 
data collection application is processed. 

processing inquiries : a telecommunications 
application involving receipt of a message 
from a remote terminal, processing of the 
message, generation of a response message, 
and transmission cf the response message to 
the originating terminal. 

queue : an item system consisting of; 

1. a queue control block; and 

2. one or more ordered arrangements cf 
items (chains). 

queue control blcck : an area in main 
storage containing control data for a 
queue. Abbreviated, QCE. 

relative line number : a number assigned by 
the user to a communications line at system 
generation. 


resource : any facility of the computing 

system or operating system required by a 
job and including main storage, 
input/output devices, the central 
processing unit# files and control and 
processing programs. 

single terminal entry : a terminal table 
entry containing information on a single 
terminal. 

telecommunications : A general term 

expressing data transmission between a 
computing system and remotely located 
devices via a unit that performs the 
necessary format conversion and controls 
the rate of transmission. 

Teleprinter : a trade name used by Western 
Union to refer to its telegraph terminal 
equipment. 

Teletype : a trademark of the Teletype 

Corporation. A system used for 
transmitting messages to remote points; the 
system employs keyboard or paper tape 
sending and printed receiving. 

Teletypewriter : a trade name used by AT6T 

to refer to its telegraph terminal 
equipment. 

Teletypewriter Exchange Service 0£WX) : a 
switched network providing the means for 
interconnecting AT&T subscribers. 

terminal: a point in a system at which 

data can enter, leave,, or enter and leave. 

A terminal can also be a control unit to 
which one or more input/output devices can 
be attached (see component). 

terminal name : the symbolic name for a 
terminal, as assigned by the user. 

terminal table : an ordered collection of 
information consisting of a control field 
for the table and blocks of information on 
each terminal from which a message can 
originate, and each terminal, group of 
terminals, and processing program to which 
a message can be sent. 

terminal table entry : a block of 
information on a terminal, group of 
terminals,, or processing program; one of 
the units that comprise the terminal table. 

text: that part of the message of concern 
to the party ultimately receiving the 
message (that is„ the message exclusive of 
the header, or control information). 
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Communication Line Group 17,33,38-45 
DASD Checkpoint Records 18,34,35-37, 

HO 

DASD Message Queues 18,36 
VCV Vocabulary 18,123 
Message Log 35,125,123 
File Activation 62-64,134 
File Deactivation 106, 135 
File Definition 18,33-45,123 
File Initialization 62-64, 134 
Format, Macro Instruction 189 ,18 9 
Functional LPS Macro Instructions 61,138 

GET Macro Instruction 7,26 

Glossary 211 

Group Code Entry 47,91 

Half-Duplex Line 10 
Header 

Format 21-22,67,117,1 38 
Incomplete 81 
Message 21-22 
Prefix 23,24,27,158 
Scanning 67,168 


IBM 

1030 

193 


IBM 

1050 

193-194 


IBM 

1060 

194-195 


IBM 

2260 

(Local) 

10,34,63,57,195 

IBM 

2740 

198-199 


IBM 

2740 

Model 2 

57,58,199-200 

IBM 

3944 

200 
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to nonaudio topics. Page, references 
in this type. refer to audio topic*. 


Idle Characters, Use of 61-62,89 

Incomplete Header 81 

Information Mode 117 

Initiate Function 84,85 

Input Sequence Number 46,81,91 

I nquiry Mode 117 

Insufficient Buffers 82 

INTERCPT Macro Instruction 80 

INTERCPT Operator Control Message 109,110 

Interval, Checkpoint 49,111 

Interval, Polling 41 

INTREL Operator Control Message 110 

Invalid Destination Code 81,91 

Invalid Source Code 81,93 

ITA2 Alphabet 204 

Leased Line 11 

Limiting Number of Messages 89 
Line, Access 11 

Line and Station Configuration 10 
Line, Communication (see Communication 
lines) 

Line Connection, Establishing 13-14,28- 
29 

Line Control Sense Information 67 
Line Error Byte 140 
Line Error Counters 100,101,108,747 
Line Procedure Specification (LPS) 17,64- 
68,736 

Components of 65-66, 737 

Delimiter Macro Instructions 66,70-73, 
737 

End Receive Subgroup 65,70 
End Send Subgroup 65,71 
Error-Handling Macro Instructions 67, 
739 

Functional Macro Instructions 67,138 
Header Field Scanning 67,168 
Macro Instruction Summary 159,189 
Receive Header Subgroup 65,73 
Receive Segment Subgroup 65,73 
Register Usage 168,76$ 

Send Header Subgroup 65,73 
Send Segment Subgroup 65,73 
User Routine 98,99,742- 7 43 
Line Table, Audio 131,129 
LIME Macro Instruction 132 
LINETBL Macro Instruction 132 
LIST Macro Instruction 53 
LOGSEG Macro Instruction 83,140 
Logging Messages 35,83,749 
Longitudinal Redundancy Check (LRC) 77 
LPSTART Macro Instruction 71,737 

Management of Switched Lines 28-29 
Macro Instruction 

Coding Format 188,7$$ 

File Activation 62-64,734 
File Deactivation 106 


Macro Instruction (continued) 

File Definition 18,33-45,723 
File Initialization 62-64,734 
LPS (see Line Procedure Specification) 
Summary of 159,189 
Macro Instructions 
ARUMGTVP 138 
BREAKOFF 74 
BUfARU 134 
BUFFER 61 
CANCELM 74 
CHECKARU 739 
CHNGP 103 
CHNGT 102 
CLOSE 107 
COPYC 101,745 
COPYP 102-103 
COPYQ 104-105 
COPYT 101-102 
COUNTER 75 
DATESTMP 75-76 
DIRECT 76 
DTFQT 35-45,724 
ENDRCV 70-71 
END READY 64 
ENDSEND 71 
EOA 76-77 
EOB 77 
EOBLC 77-78 
ERRMSG 78-80 
GET 7,26 
INTERCPT 80 
LINE 131 
LINETBL 132 
LIST 53 
LOGSEG 83,7 49 
LPSTART 71,737 
MODE 83-86 
MSGTYPE 86 
OPCTL 87-88 
OPEN 63-64,735 
OPTION 49-50 
PAUSE 88 
POLL 57-59 
POLLIMIT 89-90 
P0STARU 138 
POSTRCV 72 
POSTSEND 72-73 
PROCESS 54,737 
PUT 7,26 
RCVHDR 73 
RCVITA2 97 
RCVSEG 73 
RCVZSC3 97 
REPEAT 141 
REROUTE 90 
ROUTE 91 
SENDHDR 73 
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Macro Instructions (continued) 

SENDSEG 73 
SEQIN 91 
SEQOUT 92 
SKIP 92 
SNDITA2 97 
SNDZSC3 97 
SOURCE 93 
STARTARU 145 
STARTLN 100 
STOPARU 148 
STOPLN 100 
TERM 50 
TERMTBL 48 ,130 
TIMESTMP 93 
TRANS 9 4, 141 
(n/ORV 133 
W0RVTBL 133 
WRU 98 
Message 

Canceling 7 4 
Code Translation 94,169 
Control 13-14 
Counting 75 
Editing 19-20,185,20 
Flow 23-27 ,118-120 
Format 21-22,JJ 1-118 
Header 21-22 
Intercepting 80 
Logging 35,83 ,123 
Operator Control 108,j 4 7 
Priority 83-84 
Processing 15 
Rerouting 90 
Routing 76,91 
Segment 21 

Sequence Number 46,81,91 
Switching 30 
Translation 94,169,169 
Type 86 
Work Unit 21 

Message Control Program 7,16-17,32-33 
Composition 32 
Functions 19-20,32,/22 
Sample Programs 162,165 
Message Log File 35,83, 123 
Message Processing Applications 30,31,12/ 
Message Processing Program 7,16 
Message Switching Application 30 
Message Switching Terminal Test 206 
MOD2260 Mode 84 

Mode, Conversational 31,54,84-85,117,121 
MODE, Macro Instruction 83-84 
Modifying Control Information 102,103 
MSGTYPE Macro Instruction 65,86,87 
Multiplexer Channel 8 

Negative Responses 13,56 
Network 11-12 

Configuration 12 
Control Facilities 100 ,144 


Network (continued) 

Nonswitched 11 
Switched 11 

OBR (see Outboard Recorder) 

On-Line Terminal Testing 112,206 
OPCTL Macro Instruction 87 
OPEN Macro Instruction 63,135 
Operating Environment 17 
Operator Awareness 114-115,1 49 
Operator Control Facility 108, 14 7 
Input Messages 108,147 
Output Messages 108 ,108 
OPTION Macro Instruction 49 
Optional Terminal-Table Subfields 46,49,50 
Outboard Recorder (OBR) 43,48,49,108,115- 
116,154 

Output Sequence Number 46,81,92 

PAUSE Macro Instruction 62,88 
Pointer, Scan 68-70 
POLL Macro Instruction 57-59 
POLLIMIT Macro Instruction 89-90,93 
Polling 13-14 
Address 13-14 
Characters 13,51 
Interval 41 
Limit 89 
List 56-59 
Polling List 

Defining 56-59 
Formats 157 
Positive Response 13 
P0STARU Macro Instruction 138 
POSTRCV Macro Instruction 72 
POSTSEND Macro Instruction 72-73 
Prefix 

Header 23-27 
Text 23-27 
Priority 

Message 84 

Receiving and Sending 27-28,42 
System 17 
Private Line 11 

PROCESS Macro Instruction 54 ,131 
Process Program Entry 48,54,129 
Process Queue 

DASD 18-19,26,54 
Main Storage 18-19,26,122 
Process Collected Data 31 
Processing Inquiries 31 
Processing Program 7,16 
PUT Macro Instruction 7,26 

QTAM 

Capabilities 9-10,19-20 
General Concepts 16-20 
Machine and Device Requirements 9 
Operating Environment 17-18 
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QTAM (continued) 

Polling System 13-14 
Terminal Types Supported by 8,9 
Queue 

Audio Output 18 
DASD Destination 18-19,23,25 
DASD Process 18,24,54 
MS Destination 18,25 
MS Process 18,26,32,122 

RCVHDR Macro Instruction 73 
RCVITA2 Macro Instruction 97 
RCVSEG Macro Instruction 73 
RCVZSC3 Macro Instruction 97 
Receive Header Subgroup of LPS 65,73 
Receive Segment Subgroup of LPS 65,73 
Relative Line Number 29,38,50,126 
RELEASEM Operator Control Message 110 
Remo te Terminal 10 
Repeat Code 118 
REPEAT Macro I ns truction 141 
Request Address Terminal Test 207 
REROUTE Macro Instruction 54,90,93 
Response Message 31 

Restarting the Message Control Program 
112 

Rotate Terminal Test 205 

ROUTE Macro Instruction 74,76,91,94 

Routing Messages 76,91 

Initiate Function 84,85 

Scan Pointer 68-70 
Scan Routine,QTAM 67 
SDR (see Statistical Data Recorder) 
Segment, Message 21 
Send Header Subgroup of LPS 65,73 
Send Segment Subgroup of LPS 65,73 
SENDHDR Macro Instruction 73 
SENDSEG Macro Instruction 73 
SENSE Bits 113 
SEQIN Macro Instruction 91,93 
SEQOUT Macro Instruction 92 
Sequence Checking 81,91 
Sequence Number Error 81,91 
Service Facilities 108,147 
Should-Not-Occur Error 81 
Single Terminal Entry 46,50,152 
SKIP Macro Instruction 92 
Skipping of Header Fields 92 
SNDITA2 Macro Instruction 97 
SNDZSC3 Macro Instruction 97 
Source Code 19,90 
Invalid 81,93 

SOURCE Macro Instruction 93 
STARTARU Macro Instruction 14b 
STARTARU Operator Control Message 148 
STARTLN Macro Instruction 100 
STARTLN Operator Control Message 110 
Station 10 

Statistical Data Recorder (SDR) 43,48,49, 
108,114-116,154 


Status Bits 113 
ST0PARU Macro Instruction 144 
ST0PARU Operator Control Message 148 
STOPLN Macro Instruction 100 
STOPLN Operator Control Message 110 
Stored compare Terminal Test 206 
Suppressing Message Transmission 80,109 
148 

SWITCH Operator Control Message 111 
Switched Network 11 
Management of 28-29 


Telecommunications Control Unit (TCU) 

8-10 

Telecommunications System, Canceling 107 
Telecommunications System Concepts 10-15 
TERM Macro Instruction 50 
Terminal 10 

Addressing 13-14 
Inoperative 81 
Local 10 

Operator Control 87-88 
Polling 13-14 
Remote 10 
Testing 112,205 
Types Supported by QTAM 8,9 
Terminal Table 

Defining 46-56,129 

Distribution List Entry 47,53,152 

Entry 46 

Entry Formats 151-155 
Example 54,55,156 
Group Code Entry 47 
Optional Area 46,49,50 
Process Program Entry 48,54, 131,155 
Single Terminal Entry 46,50,152 
TERMTBL Macro Instruction 48, 130 
Text Prefix 23-27,158 

Threshold Line Error Counters 41,113,12$, 
145 

Threshold Values 113 
Tilt Terminal Test 206 
Timeout Exceeded Error 81 
TIMESTMP Macro Instruction 93 
TRANS Macro Instruction 94,141 
Translating Device Code 94,169,169 
Translation Tables 96,169,141,169 
Transmission Code 94,169,169 
Transmission Error 77,81 
Twist Terminal Test 206 
TWX Terminals 199 

User Routine in LPS 98-99,142-14 3 

Western Union 115A Terminals 202 

Word Table 133 

WORD Macro Instruction 133 

Words, PCI/ 133,113 

W0RVTBL Macro Instruction 133 
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Work Area, Message Processing 25,26 
Work Area for Control Information 101-105 
146 

Work Unit 21 

Write Line Address Terminal Test 207 
WRU Macro Instruction 98-99 
WTTA Lines 28 
WTTA Terminals 202-203 

Zero-Length Message 81 
ZSC3 Alphabet 205 
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